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DISCLAIMER : 


DISCLAIMER ON CONTENTS 


The following should be read and understood before purchasing 
and/or using this Interface Standard/Design Guide. 


The technical information contained in this document is accurate, 
to the best of the knowledge of the author and the reviewers. 
However, given the volatile nature of the computer and electronics 
industry, along with the lack of access to original design 
documentation on the 99/4A system, there is no warranty that the 
contents of this manual will be free from error or will meet the 
specific requirements of the purchaser. The purchaser assumes 
complete responsibility for any decision made or actions taken based 
on information obtained using the contents of this manual. Any 
statements made concerning the utility of the contents are not 
construed as expressed or implied warranties. 


The author reserves the right to revise any of the contents at 
any time without notice. However, registered owners will be notified 
if significant revisions or additions to the contents are made. 
Purchasers are encouraged to notify the author of any errors found in 
the text or graphics. 


The author makes no warranty, either expressed or implied, 
including but not limited to any implied warranties of fitness, 
operability, or validation of design, regarding the contents or any 
information derived therefrom, and makes all contents available solely 
on an "as is" basis. 


In no event shall the author or the reviewers be liable to anyone 
for special, collateral, incidental, or consequential damages in 
connection with or arising out of the purchase ог use of this 
literature and the sole and exclusive liability of the author, 
regardless of the form of the action, shall not exceed the purchase 
price of this manual. Moreover, the author shall not be liable for 
any claim of any kind whatsoever by any other party against the user 
of this manual. | 


Texas Instruments did not contribute to, commission, nor approve 
the creation of the Interface Standard/Design Guide. All information 
used in deriving the contents of this manual are available in the 
public domain. "TI", "TI 99/4A", and "99/4A" are registered 
trademarks of Texas Instruments. 
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RESOURCES 


This document was created on TIWriter Version 4.2, by R. A. Green 
Software. Graphics were created with AutoSketch 2.0. 


Disassembly of existing console and DSR code was accomplished via 
Millers Graphics EXPLORER and DISkASSEMBLER programs. Тһе program 
"GPLDIS" was used to disassemble the GPL code in GROMs 0-2. Reference 
9 provided input on console routines. References 9, 10, and 14 were 
used to compile information on use of console RAM locations as they 
pertain to DSRs. 


References 1, 2, 4, and 5 provide information on the TMS9900 
microprocessor апа related system design. References 1, 8 and 14 are 
excellent sources on assembly programming. Reference 13 provides 
completely disassembled and commented DSR codes for several 
peripherals. Reference 15 provides information on the Graphics 
Programming Language, which was useful in disassembling code in GROMs 
0-2. 


All references listed are recommended as excellent sources of 
information for the 99/4A and its Peripheral Expansion System, and the 
reader 15 encouraged to consult them for more information. Where 
possible, consult with the local library about obtaining references 
via the InterLibrary Loan System, using the ISBN number. Below is а 
list of current addresses for some of the references: 


Millers Graphics 
1475 W. Cypress Ave. 
San Dimas, CA 91773 


Texas Instruments Inc. 
Data Book Marketing 

PO Box 117692 

Carrollton, TX 75011-7692 
(800) 232-3200 


The Bunyard Group 
PO Box 62323 
Colorado Springs, CO 80962-2323 


LL Conners Enterprises 
Computer and Electronics 
1521 Ferry Street 
Lafayette, IN 47904 


Readers interested in obtaining copies of Technical Data and the 
GPL manual may contact the author directly for more information. 
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UTILITY PROGRAMS 


A 5-1/4" single sided, single density diskette containing utility 
programs 15 provided with the manual to assist the peripheral 
developer in creating DSRs and application programs. The purpose of 
including these programs with the manual is to provide (in the 
author's opinion) the "best" utility programs available to the 
developer such that DSRs may be quickly written, debugged and 
released. Disassemblers are also included for reverse engineering 
console/peripheral code as needed to insure compatibility. [Use of 
Millers Graphics DISKASSEMBLER for disassembly is highly recommended; 
DISKASSEMBLER is available from several sources.] 


Each of the programs took several days of development by their 
authors to complete. Responsible purchasers are obligated to forward 
a contribution to the software authors to acknowledge the usefulness 
of their products, and to encourage development of future products. 

HOTBUG is not fairware; consult the documentation for proper 
registration of ownership. Тһе README file оп the disk contains а 
list of the utility programs, program description, recommended 
contribution amount, author name and current address. 
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INTRODUCTION 


The purpose of this manual is to consolidate all information 
available in the public domain on the design and development of 
peripherals for the TI 99/4A computer into one reference. There are 
several excellent documents on the hardware and software of the 
console and its peripheral system available; however, this manual has 
been specifically written for designer/developers who wish to create 
new hardware and/or software for TI 99/4A peripherals. 

The manual 15 an intermediate level text in that it 15 assumed 
that the reader is familiar with the TMS9900, its assembly language, 
the 99/4A peripheral system, the File Management System, and general 
computer апа electronics concepts. Readers who are novices in any of 
these areas should consult the appropriate references before using 
this manual. Although some overlap of information exists between this 
manual and the references, the reader is urged to consult the 
references as needed for information not included in the Interface 
Standard/Design Guide. 

As the title implies, this manual is meant to provide a 
consistent basis, or standard, for designers to create peripherals 
that will be compatible not only with the ТІ 99/4A, but with other 
peripherals as well. Basic information on hardware and software 
techniques is also provided for use by the developer. 

Sections A-H cover the hardware aspects of the console and 
peripherals, and includes design information on chips and circuits. 
New peripheral types are defined in Section C, and existing peripheral 
locations аге assigned in Section G. Section I covers the basics of 
Device Service Routine (DSR) construction. Section J discusses how 
the routines built into the console access peripherals and their DSRs. 
Where ever possible, examples are given of hardware and software 
concepts to assist the reader. 

The author hopes that all readers will find the Interface 
Standard/Design Guide useful and informative. The author would also 
like to thank the following people who reviewed and commented on the 
original draft of the manual: 


John Willforth Mike Dodd 


Matt Beebe Barry Boone 
Jim Reiss Mid-Atlantic 99ers 
Peter Hoddie John Johnson 


Paul Carlton 
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SECTION A: 9900 SIGNALS/INTERFACING 








1.0 Introduction 


The TMS9900 microprocessor has 64 pins, 49 of which are used as 
signals to communicate with other chips and the outside world. These 
signals can be grouped into two basic sets, or buses: memory bus апа 
CRU bus. The memory bus can be further divided into three types of 
signals: address, data, and control. This section will briefly 
discuss the function of the TMS9900 signals, and how they are used and 
modified by the /4A system. References 1, 2, and 5 contain more 
detailed descriptions of the 9900 signals. 


2.0 Memory Bus 


The memory bus is used to communicate with memory chips (or 
memory mapped devices) by selecting an address, then reading ог 
writing data to or from the address. The address bus provides signals 
to select individual addresses, while the data bus provides a two way 
communication path for information to travel. Тһе control bus signals 
coordinate action between the microprocessor and other devices. Below 
is a brief description of the functions of the memory bus. 


2.1 Address Bus (A0-A14) 


The 9900 has 15 address signals, AQ - A14, with AO the most 
significant bit (MSB). These signals are driven out of the micro, and 
are used to select the address of information to be read or written. 
It is assumed that the memory system will have a 16 bit word design, 
and not a byte (8 bits) wide data bus, because the 9900 addresses 32K 
words (16 bits) for each read or write function. The 9900 cannot 
address individual bytes because there is no A15 signal to 
discriminate between even and odd bytes. To perform byte reads, the 
9900 will read two bytes simultaneously, discarding the information in 
the unused byte. То perform byte writes, the 9900 first reads two 
bytes, alters the byte being written to, and then writes both bytes 
back to memory. 


2.2 Data Bus (00-015) 


The data bus is 16 bidirectional signal lines used to read or 
write information from other devices. Since the data bus is 16 bits 
wide instead of eight, the 9900 can access twice as much information 
per unit of time than a similar micro with an 8 bit data bus. 


2.3 Control Signals (DBIN, -WE, etc.) 
Control signals are used to synchronize the operations of the 


9900 with the devices that it is communicating with. The 9900 control 
signals are summerized below; consult Reference 1 or 5 for more detail 
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оп these signals. 


in 
1/0 /4А? Signal Description 

0 Y -MEMEN used to enable memory accesses, differentiates 
between memory bus and CRU bus activity 

0 Y DBIN data bus direction, determines the direction of 
data (in or out) for the 9900 

0 Y -WE write enable, denotes writes to memory 

0 Y IAQ Instruction Acquisition Status, denotes that 
the microprocessor is obtaining an 
instruction from memory 

I Y READY memory ready status, informs micro that 
System memory is ready to be accessed. 

0 N WAIT Ready acknowledge, status signal that 9900 


acknowledges memory not ready to be accessed. 

I N -HOLD HOLD process, when active, puts 9900 signals 
in inactive state. Memory bus may now be 
driven by another device. 

0: Y HOLDA HOLD Acknowledge, informs external device that 
9900 acknowledges receipt of HOLD request. 

I Y -RESET Reset input, resets micro to initial state 

I Y -LOAD nonmaskable interrupt, forces 9900 to branch 
to address >FFFC for new program counter and 
wOrkspace values 

I N ICO-IC3 interrupt code 0-3, inputs for up to 16 
maskable interrupts 

I Y -ІМТКЕО Interrupt Request, informs 9900 that an 
interrupt code is valid on ICO - IC3 


[signals may be either available externally, or used only internally 
by the console; signals may be altered or unused in current design] 


3.0 CRU Bus 


The input/output bus on the 9900 is known as the Communication 
Register Unit (CRU) bus. The CRU bus is similar in concept to the 
memory bus, with the following exceptions: 


1: The memory bus can communicate in words (16 bits) with a set 
of odd and even addresses. The CRU bus associates one bit per address 
accessed by the 9900. 

2: The CRU address space is limited to 20000 to >1FFF, where as 
the memory bus can address 20000 to >FFFF. These are separate апа 
distinct addresses; control signals are used to differentiate between 
memory address space and CRU address space. 

3: The CRU bus is used primarily to control peripherals (on/off) 
versus communication of data because the memory bus transfers тоге 
bits per access than the CRU bus. 

4: The CRU bus does not have as many control signals as the 
memory bus, sometimes causing design concerns when developing 
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circuitry. 


The CRU bus consists of the following signals, all of which are 
used in the /4A system: 

A3-A14 (out) These lower order address lines define the CRU space 
20000 to >1FFF. Same lines as used by memory bus. 

CRUCLK (out) CRU Clock, used during CRU output to inform external 
device that address bus and CRUOUT output bit signals 
are stable. 

CRUOUT (out) CRU Output Data, outputs value of bit when CRUCLK 
is active. 

CRUIN (in) CRU Input Data, inputs bit value into 9900 


References 1 and 2 have excellent discussions of the CRU bus as 
implemented by the 9900. 


4.0 Interfacing with the /4A 


The signals available for the 9900 are used in various 
combinations to allow it to interface to external devices. This 
section will cover the relationships between the signals on the memory 
and CRU buses as they are presented to peripheral devices by the /4А 
system. Not all 9900 signals are available in the /4A system for use 
with peripherals; likewise, the relationship and timing of some 
signals are radically modified by the /4A system and do not conform to 
the original 9900 signal format. Most notable is the fact that the 
/4А system has an 8 bit peripheral data bus, not 16 bits. 


4.1 Memory Bus Interfacing 


The /4A system will read ап odd and even byte within a word 
boundary by reading the odd byte first, then the even опе. Control 
logic circuitry internal to the /4A allows it to read the first byte, 
then the second, and then reassembles them into a word before 
presenting it to the 9900. Figure A.1 shows the appropriate signal 
timing and relationships. 

The control logic is: 


IF -MEMEN is low AND DBIN is high, THEN a memory READ is 
occuring. 


There is no need to include -WE in decoding for a Read. The /4A 
system automatically inserts two wait states (333 ns each) for each 
byte access. Allowing for 100 ns settling time for the address lines 
to become valid after -MEMEN goes low, a peripheral has up to 650 ns 
to provide valid data on the data bus. 

A0-A14 are held constant per memory read - - - only A15 changes 
state during a memory access for a Read. А15 is generated by the /4А 
System to differentiate between odd and even bytes, and is not 
produced by the 9900. 
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The /4А system writes information to an odd and even byte within 
a word boundary with timing similar to a Read operation. Figure A.2 
shows signal timing and relationships for a Write operation. The 
control signal logic is: 


IF -MEMEN is low AND DBIN is low, THEN а memory Write is 
оссигіпд. 


Data оп 00-07 is valid when -WE goes low. 

Data is presented on the data bus апа is valid (-WE goes low) 
approximately 333 ns after -MEMEN and DBIN are both low; -WE remains 
low for 578 ns, typically. One -WE pulse is generated per byte Write, 
whereas the 9900 generates only one -WE pulse per word. Recall also 
that the 9900 always performs a Read operation to а word boundary 
prior to а Write operation; this is true of the /4A system also (ie- 
the /4A reads two consecutive bytes, even when performing a single 
byte write operation). 


4.2 CRU Bus Interfacing 


Input and output on the CRU bus is more simplistic but also can 
create problems for designers if certain relationships аге ignored. 
The CRUCLK signal of the 9900 is inverted by the /4A system to produce 
-CRUCLK. This is used to strobe a CRU bit out of. the /4A via the 
CRUOUT line, similar to the way -WE strobes data from the 00-07 lines. 
The timing relationship fo a CRU output series is shown in Figure A.3. 
The control signal logic is: 


IF -МЕМЕМ is high AND -CRUCLK is low THEN а CRU bit is output on 
CRUOUT. 


The -MEMEN signal allows the /4А to multiplex the A15 and CRUOUT 
on the same pin; the pin is for "A15" if -MEMEN is low, and for 
"CRUOUT" if -MEMEN is high. 

Input on the CRU bus is accomplished by establishing a valid 
address on А0-А15, then reading the bit value on the CRUIN line 400 ns 
after the address is valid. 

No other control signals are needed to define а CRU Read 
operation. Unlike the memory bus operation, external devices have no 
warning that an operation on the CRU bus is about to occur (-МЕМЕМ 
going low notifies the system that a memory bus is going active; there 
is no corresponding "-CRUEN" signal). Designers of peripherals 
utilizing the CRU bus must be aware of this restriction. 
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SECTION B: CONSOLE (44 PIN) AND PBOX (60 PIN) CONNECTORS 


1.0 Introduction 


Not all of the signals from the 9900 are made available to the 
outside peripherals. Тһе side connector оп the console has 44 pins, 
38 of which are signals (the rest are power and ground pins). Тһе 
PBox bus has a 60 pin connector, which has 12 power and ground pins, 7 
unused (currently) signals, and 41 active signals. The signals for 
the console and PBox are listed below, along with comments of their 
intended functions. Figures B.1 and B.2 show the console and PBox 
connectors as viewed looking into the connector. 


2.0 Console 44 Pin Connector 
The side connector on the console is an edgecard type with 44 


pins spaced 0.10" pin to pin spacing. The signals, functions and pin 
numbers are as follows: 


Signal Pin I/O Comments 

АО MSB) 31 0 Address bus signals 

A1 30 0 2 

А2 20 0 и 

АЗ 10 0 " 

A4 7 0 y 

A5 5 0 ы. 

Аб 29 0 x 

A7 17 0 " 

A8 14 0 

A9 18 0 Е 

А10 6 0 " 

A11 8 0 " 

A12 11 0 п 

A13 15 0 ч 

А14 16 0 м 

А15/ 19 0 A15 is created by logic internal to the 

CRUOUT console, not by the CPU. CRUOUT is gated 
A15, and is not active unless -MEMEN is 
high. 

DO 37 1/0 Bidirectional data bus 

D1 40 1/0 " 

D2 39 I/0 Н 

03 42 1/0 " 

D4 35 1/0 » 

D5 38  I/0 А 

06 36 1/0 " 


D7 34 1/0 В 
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Signal Pin I/O Comments 

-MEMEN 32 0 Same as for 9900 

DBIN 9 0 ы 

-МЕ 26 0 This is highly modified from the original 


9900 signal into two active low -WE signals 
per cycle (one per byte) 

-MBE 28 0 Memory Block Enable. Created by console 
logic; device enable signal for the 24000- 
»5FFF memory block. Convenient for side 
mounted peripherals. Signal not transmitted 
to PBox bus. 


-CRUCLK 22 0 Phase 3 clock, inverted 

CRUIN 33 I Same as for 9900 

READY 12 I и ", with pull up resistor 
IAQ 41 0 Not transmitted to PBox bus 

-LOAD 13 I и 

-RESET 3 0 This is output, and cannot be used to 


input a -RESET signal 

-EXT INT 4 |I External Interrupt, active low, used by 
peripherals to indicate an interrupt 
request to the 9900 


-PH 3 24 0 Phase 3 of the 9900 4 phase clock, 
inverted to active low. 

SBE 2 0 Speech Block Enable; indicates access to 
Speech memory at 29000/29400 

AUDIO IN 44 1 Input for audio from speech module to sound 
chip 

+5\/ 1 Supply voltage for speech module 

-5V 43 : 


*Not connected to PBox or interface cable. 
DO NOT use for side peripherals, or damage 
to console power supply may occur.* 

GROUND 21,23,25,27 Ground 


3.0 PBox Bus Signals - 60 Pin Connector 


The PBox bus uses 60 pin female connectors with pins spaced 0.10" 
pin to pin spacing. Not all of the signals available from the 44 ріп 
connector are available in the PBox bus. The Interface Card sold with 
the PBox determines which signals were transferred. The PBox end of 
the cable also holds some (currently) unused signals high, by tieing 
them to a 5V source via a resistor. The signals, functions, апа pin 
numbers are as follows: 





| SECTION B: CONSOLE/PBOX CONNECTORS PG B3 


Signal Pin 1/0* Comments 

АО.А 43 І Address bus signals; "A" suffix denotes 

A1.A 44 | PBox signal 

A2.2 41 I А 

АЗ.А 42 І " 

AA. A 39 | T 

А5.А 40 I " 

A6.A 37 I Ы 

А7.А 38 1 b 

АВ.А 35 I " 

А9.А 36 I ч 

A10.A 33 I Ы 

А11.А 34 1 2 

А12.А 31 I " 

А13.А 32 I i 

А14.А 29 I " 

A15/ 30 I " 

CRUOUT.A 

AMA.A 46 HIGH Extended address bit, held high by interface 

AMB.A 45 HIGH card 

AMC.A 48 HIGH i 

DO 28 1/0 Data bus signals 

D1 25 1/0 5 

02 26 1/0 Ч 

рз 23 1/0 " 

D4 24 1/0 " 

05 21 1/0 S 

D6 22 1/0 s 

D7 19 1/0 И 

-MEMEN.A 56 І Same as 44 pin side port signals 

DBIN.A 52 I ч 

-WE.A 54 | " 

-CRUCLK.A 51 I х 

CRUIN 55 0 

READY.A 4 0 j 

IAQHA 14 М/С IAQ and Hold Acknowledge gated together. For 
use with 9995 based machines as Hold Ack. 

-LOAD 18 МС Not used with /4A 

-RESET 6 1 

-ІМТА 17 0 -EXT INT 

-CLKOUT 50 I -РН 3 

AUDIO 10 0 

SCLK 8 N/C System clock. Use is not defined with /4A 

-LCP 9 N/C 9995 indicator. Low=9995 machine, high=/4A. 
Possible use to switch peripherals to faster 
speed. 

PCBEN 12 HIGH Enables cards in PBox. Low disables all cards. 


-HOLD 13 МИС Active low HOLD request for 9995 based machines 
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Signal Pin 1/0* Comments 

-SENILA 15 HIGH Interrupt level A and B Sense Enable. Allows 

-SENILB 16 HIGH computer to quickly identify peripheral 
interrupt. Not used by /4A system. 

-RBDENA 11 0 Active low remote data bus driver enable line. 


Each peripheral that utilizes the DATA bus 
must generate an -RDBENA signal when accessing 
the data bus. This signal enables the 1.5245 
transciever in the console end of interface 


card. 
GROUND 3,5,7,20,27 Ground 
47,49,53 
UNREG 8V 1,2 Used to supply unregulated voltages to voltage 
UNREG -16V 57,58 regulators mounted on peripheral cards. 


UNREG +16V 59,60 


[*Either input into the PBox bus, or output to the console] 


4.0 General Notes 


4.1 The interface cable shares a common ground between the 
console and PBox. Positive апа negative voltages аге not 
interconnected between the PBox and the 44 pin console connector. 


4.2 -КВОЕМА is not needed for peripherals that do not use the 
data bus (00-07). If used, it should be active low with the chip 
enable signal for the data bus transciever for the peripheral. 


4.3 Unregulated +8V, «16V, and -16V sources are provided to allow 
for voltage regulators (as needed) on each peripheral card. Temporary 
voltage transients on an individual card will not affect the other 
peripheral cards. 


4.4 Signals held high (45V) by the Interface Card cannot be used 
unless the Interface Card is removed, modified or replaced with a 
different interface card. 


SECTION В: CONSOLE/PBOX CONNECTORS 


FIG. B.1: 44 PIN SIDE EDGEBOARD CONNECTOR 
(VIEW LOOKING INTO CONSOLE SIDE) 
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НС В.2: 60 PIN PBOX CONNECTOR SOCKET 





+8V v4 2 48V 
GROUND 3 4  READY.A 
GROUND 5 6 -RESET 
GROUND 7 8 SCLK 
SECR 9 10 AUDIO 
—RDBENA 11 12 PCBEN 
HOLD 13 14 IAQHA 
—SENILA 15 16 —SENILB 
-ІМТА 17 18 —LOAD 
07 19 20 GROUND 
D5 21 22 06 
03 23 24 04 
01 25 26 02 
GROUND 27 28 00 
А14.А 29 30 A15/CRUOUT 
АТ2 А 31 32 А13.А 
A10.A 33 34 АТТА 
AB.A 35 36 A9.A 
Аб.А 37 38 A7.A 
A4.A 39 40 АБА 
А2.А 41 42 АЗА 
АО.А 43 44 ALA 
АМВА 45 46 АМА.А 
GROUND 47 48 АМСА 
GROUND 49 50 —CLKOUT 
—CRUCLK.A 51 52 DBIN.A 
GROUND 53 54 -МЕА 
CRUIN 55 56 —MEMEN.A 
—16V 57 58 —16V 
+16м 59 60 +16V 
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SECTION C: PBOX CARD ELECTRONIC FEATURES 


1.0 Introduction 


Each peripheral card designed to be used with the PBox will have 
certain features that will not only allow the device to work properly, 
but will keep it from interfering with other devices and the computer. 
Due to the diverse nature of possible peripheral devices, not all of 
the following electronic features will be implemented on every device. 
The peripheral designer is responsible for insuring that his or her 
design utilizes the appropriate buffering and device selection 
techniques to prevent bus contention between devices. 


2.0 Interfacing Notes 


As noted previously, the PBox has two basic bus systems, memory 
and CRU. The CRU bus is used to control most peripherals, while the 
memory bus is used to transfer data to and from the peripheral. The 
CRU bus can also be used to transfer data to and from a peripheral, 
but a slower rate since the CRU bus transfers information at the rate 
of one bit per cycle, whereas the memory system transfers one byte (8 
bits) each cycle. 

These two buses can be used in several designs to communicate 
between the computer and the peripheral. However, most interface 
designs can be grouped into one of five categories: 


1) CRU only (serial) 

2) Memory only 

3) CRU and Memory Mapped (non-DSR) 
4) CRU, DSR ROM, and Device 

5) Non-CRU Memory Mapped 


Each of these categories are discussed below. Note that the 
fourth category is the most common design, and the last category has 
not been defined until now. 


2.1 CRU Only 


In many ways, interfacing the computer to a peripheral via the 
CRU bus (only) 15 the simplist design of all. А peripheral that uses 
only the CRU bus to communicate has only one constraint: the CRU 
address(es) used by the peripheral must not be used by any other 
device. This is extremely important because most of the peripheral 
devices and the 9901 which drives the keyboard already have several 
СВУ addresses assigned to them. Attempting to use any of these CRU 
addresses will result in contention on the CRU bus, and possible 
activation of other peripherals on the memory bus. [Following 
sections will explain how the CRU bus is used to poll and activate 
peripherals.] Section G contains the CRU map for the /4A. Each 20100 
CRU address block has 128 addresses. Each peripheral space in the 16 
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locations reserved for peripheral devices (from >1000 to >1F00) has 
128 CRU addresses available; however, usually no more than the first 8 
CRU bits are used. The TMS9901 utilizes 32 CRU bits, starting at 
address 20000. Тһе CRU space from 20400 to ХОҒҒЕ is unassigned and 
has 12 sets of 128 CRU addresses available. It is recommended that 
peripherals based upon using the CRU bus only should be located within 
the 20400 to ООҒҒЕ CRU address range, with 128 bits available per 
CRU-only peripheral space. Table C.1 defines these twelve peripheral 
blocks. If more than 128 bits are required, then sequential 
peripheral blocks should be utilized. Any device that utilizes one or 
more of the peripheral blocks in Table C.1 shall have the CRU 
addresses clearly identified in the device documentation, and noted on 
the device itself, if possible. None of the CRU-only peripheral 
blocks are currently defined. 


TABLE С.1 
CRU-ONLY PERIPHERIAL BLOCKS 


Block CRU Address Range 
1 >0400->04FE 


2 20500-205ҒЕ 
3 20600-206ЕЕ 
4 20700-207ЕЕ 
5 20800-208ҒЕ 
6 20900-209ҒЕ 
7 20А00->0АҒЕ 
8 20800-20ВҒЕ 


9 20С00-20СҒЕ 
10 20000-200ҒЕ 
11 20Е00-20ЕҒЕ 
12 20Ғ00-20ҒҒЕ 


Note: While it is possbile to utilize СВУ addresses within the 
Sixteen polled peripheral spaces, it is not recommended since these 
bits may be used in existing or future devices. The twelve CRU-only 
peripheral blocks defined in Table C.1 should provide adequate space 
for development of these types of peripherals. 


2.2 Memory Only 


As seen in the /4A memory map, there is a total of 48K possible 
RAM space available, consisting of the following 8K blocks: »2000, 
24000, 26000, 2А000, »C000, and 2Е000. Utilization of these spaces is 
discussed below as they pertain to use in the PBox. 


2.2.1 32K Design 


The TI 32K RAM peripheral card covers the 22000 and >А000-2ҒҒЕҒ 
memory spaces. Since the operating system of the /4A was designed to 
utilize RAM in these memory blocks, there is no need for special 
controls (such as CRU) to activate this memory device, only simple 


SECTION C: CARD ELECTRONIC FEATURES PG C3 


address decoding. (See Section E.2 for more details.) The original TI 
memory card utilizes dynamic RAM; subsequent third party devices use 
more commonly available static RAM. Low power CMOS RAM is used in 
some designs along with batteries to retain data when the PBox power 
is off. 


2.2.2 »4000 Space 


The memory space from 24000 to >SFFF is reserved for paging in 
various peripheral devices and for memory mapped devices. See 
Sections 2.3 to 2.5. 


2.2.3 26000 Space 


The space >6000->7FFF is traditionally not accessed from devices 
in the PBox because the /4A system assumes that it will be accessed 
from a cartridge in the 36 pin module port. Тһе signal -ROMG on pin 
34 is used to activate the 8K block at 26000. Bus contention will 
occur if a device іп the PBox contains RAM/ROM at 26000, and a plug-in 
cartridge contains RAM/ROM/GROM at the same location. Peripheral 
devices containing memory in this 8K location are acceptable only if 
the memory is inactive upon powerup, and is activated by the user via 
hardware (switch) or software (CRU activation). This places the 
burden upon the user to activate this RAM space only after confirming 
that no module with memory in the >6000 space is inserted in the 
console. If software checking is used, a powerup routine that looks 
for "AA" at byte >6000 can be used to confirm that the space is not 
free for use. 


2.2.4 Bank Switching 


Bank switching via CRU control is acceptable for the 22000, 26000 
and >AQOO->FFFF memory spaces. However, most applications programs, 
especially BASIC utilizes these areas in predefined routines, 
particularily the 252000 block. Therefore, bank switched RAM blocks 
are useful for programs specifically designed to utilize them. As 
with other concepts, the designer must insure that two RAM blocks do 
not occupy the same address space simultaneously. Bank switching 
circuitry should be disabled by powerup or RESET activation. 


2.2.5 Extended Address Lines 


The address lines AMA, AMB, and AMC are provided in the PBox bus 
to increase the linear address space of the system from 64K to 512K. 
As with bank switching, use of these lines to extend the available 
memory space 15 acceptable, but useful only for programs specifically 
designed to utilize them. A different interface card is required for 
the /4A system to allow use of AMA-AMC, since the card holds these 
signals high. Апу memory device that uses these lines must make sure 
that AMA-AMC are high (51) when accessing the "normal" 32K. Also, the 
designer should note that most of the TI produced peripheral cards 
are not activated if either AMA, AMB, or AMC are low. 
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2.2.6 Memory Mapping 


An advanced technique for extending memory for peripherals is 
referred to as memory mapping. This technique is similar to bank 
switching, but utilizes a specialized LSI chip, the 74LS612 memory 
mapper to control generation of address lines beyond А0-А15. Тһе '612 
can be utilized to expand the address lines to accomodate up to 16 Meg 
bytes, without utilizing AMA-AMC. ІҒ a memory peripheral is designed 
to address more than 512K, then it is recommended that a memory mapper 
be located on the peripheral to generate local extended addresses for 
that device. [А description of the '612 and an application report 15 
given in TI's "LSI Logic Data Book", 1986] 


2.3 CRU Select and Memory Mapped (non-DSR ROM) 


The /4A system is designed to sequentially poll 16 peripheral 
spaces, all located in the 24000 memory space. The CRU bus is used to 
select and activate these регрһегіа15 one at a time to prevent bus 
contention. Тһе system and the 16 peripheral spaces are described іп 
Section 4.0. This section covers memory mapped devices that are 
placed in one of the 16 polled peripheral spaces. These devices may 
or may not also have applications ROM/RAM; but it does not contain a 
valid Device Service Routine program. Section 2.5 covers memory 
mapped devices that are not polled by the /4A system, and do not have 
Separate applications programs within their assigned memory space. 

Memory mapped devices are accessed at only one address, or a 
small series of addresses. An existing example of a memory mapped 
device is the 9918A video chip. For the purposes of this section, 1% 
is assumed that these devices do not require a Device Service Routine 
(DSR) ROM to properly operate. Ап applications ROM or ВАМ of up to 8K 
length may be located within the same peripheral space, as long as it 
does not place the value "AA" in the first byte, and its assigned 
address range does not include the memory mapped address(es). This 
type of device may be activated by the /4A peripheral polling system, 
but will not respond since it does not have a valid DSR header. This 
type of peripheral is different from the standard polled peripheral, 
described in Section 4.0, in that it does not need a powerup, 
interrupt or applications program that uses the /4A polling and РАВ 
access system, but does need valid addresses for memory mapped 
devices, and possibly an applications program to run. Since it would 
be located in the 24000 block, it can not be activated while the 
polled peripherals are being accessed. 

For this type of peripheral, the following requirements must be 
met: 

a) The memory mapped device must be located in the range of 
>4002->5FFF; it cannot be located at either 24000 or 24001 since it 
might be accidently activated by the polling system. 

b) The memory mapped address(es) must not overlap with any 
ROM/RAM activated by this device. 

c) The memory mapped address decoder chips, data buffers and 
ROM/RAM select chips are to be activated only when that peripheral 
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space is selected Бу the СВУ bus by the calling program, апа Бе 
deactivated when the peripheral is not selcted. 

d) The peripheral must be activated by writing a high CRU bit 
(21) to the card, and deactivated by writing a low value (20) to the 
same bit. To avoid spurious activation by the /4A polling system, it 
is recommended that the activation CRU bit not be at CRU bit 0 for 
that peripheral space. 

e) If the memory mapped device requires interrupts to communicate 
with the console, or a powerup/reset program, then it must have a 
valid DSR ROM (Section 2.4). 

f) Applications software must be provided to properly activate 
the peripheral and insure that it is deactivated when communication is 
complete. Due to potential bus contention from another interrupt 
driven peripheral (which would automatically activate the polling 
System), all interrupts should be suspended via a LIMI 0 command by 
the applications software, then restored when the device is 
deactivated. 

g) The device should utilize one of the peripheral spaces and its 
assigned CRU bit address range from the table in Section 4.0. 





An example of this type of peripheral would be a Real Time Clock 
(RTC) that is periodically read by an applications program, and does 
not generate interrupts. Тһе applications program would convert the 
RTC's output into the desired format, and place the time on the 
Screen. When the applications program reads the RTC, or writes to set 
the time, external interrupts are suspended, the peripheral device is 
activated and accessed, then deactivated and interrupts аге 
reactivated. 


2.4 CRU Select, Device and DSR ROM 


This type of peripheral is similar to those described in Section 
2.3, except that a ROM device with a valid DSR must be included for 
the device to properly respond to the /4A polling system. The 
software section of this manual covers requirements for creation of 
DSR software. ROM/RAM up to 8K in length may be located in the 
>4000->5FFF space, and must not overlap with any other device оп the 
peripheral that is memory mapped or uses other address decoding 
schemes. 

For this type of peripheral, the following requirements must Бе 
met: 

a) The DSR memory must be located starting at address >4000, and 
may extend to >5FFF. 

b) Permanent memory (ROM, PROM, EPROM, EEPROM) is recommended for 
holding the DSR. ВАМ may be used, if loaded after powerup. Use of 
RAM for holding the DSR prevents use of the peripheral until the DSR 
is loaded. Non-DSR RAM (for scratchpad or data storage) may be used 
as long as the total memory (DSR + non-DSR) is 8K or less. 

с) Any other devices оп the peripheral must not share the same 
address space as the ROM/RAM. 

d) The DSR memory must be designed such that the data buffers, 
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DSR ROM/RAM select chips and any other device requiring address 
decoding are to be activated only when that peripheral space is 
selected by the /4A polling system. This system requires that the 
first CRU bit of that peripheral space activate the peripheral by 
writing a high value (=1) when it is selected, then deactivate the 
peripheral by writing a low value (=0) to the same CRU bit. 

e) If the peripheral utilizes interrupts, then it must have an 
open collector driver connected to ground that can be cleared by the 
applications software once the peripheral is accessed. 


An example of this type of peripheral is the RS232 cards, which 
are located at >1300 and >1500, and contain both DSR ROM and other 
chips, like the TMS9902 UART. See Section 4.0 for more details on how 
these peripherals are accessed by the /4A system. 


2.5 Non-CRU Memory Mapped Devices 


One of the drawbacks of the /4A's memory map is its utilization 
of the 8K memory space at 28000 to >9FFF. This memory space is 
assigned to the internal RAM and seven memory mapped devices, all of 
which are block decoded in 1К increments. Therefore, the RAM and 
memory mapped devices will respond whenever an access is made to an 
address within the assigned 1K block. 

To allow for implementation of memory mapped devices NOT accessed 
internally by the /4A system, the memory space of »>4000->5FFF is 
assigned for non-CRU memory mapped devices. This space can be 
accessed only when none of the 16 polled peripherals are paged in by 
the CRU bus. 

For this type of peripheral, the following requirements must be 
met: 

a) The peripheral must be disabled whenever a CRU access is made 
to one of the 16 polled peripherals, and enabled only when none of the 
polled peripherals is active. 

b) The peripheral must be decoded to respond within one of the 8 
1K blocks as defined below: 


Memory mapped space Address 
»4000-»43FF 


24400-247ҒҒ 
>4800->4BFF 
»4C00-»4FFF 
>5000->53FF 
25400-257ҒҒ 
25800-25ВҒҒ 
25С00-25ҒЕҒ 


Со з ОУ ол > о м ~ 


If more than one address is needed, it shall be within the 
assigned 1K block. 
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FIG. С.1: PERIPHERAL: TYPES 
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3.0 General Notes on Buffering, Activation, and Misc. Signals 


To insure that peripheral devices do not cause bus contention, 
and are accessed properly, certain design features must be 
incorporated. Most devices will have to be buffered from the memory 
bus, activated only when that device is selected, and be capable of 
generating signals to the console of its status. The following 
sections discuss these design features. 


3.1 Buffers 


Devices which utilize the data bus must have a bidirectional 
driver, such as а 'LS245, with direction control and enable signals. 
The bus driver chip should be activated by the peripheral activation 
CRU bit (see 3.2) if a polled peripheral; other peripheral types will 
utilize other activation schemes. Other signals (address, control) 
should be driven by a 'LS244 (except as noted in 3.4), which is always 
active. 


3.2 CRU Peripheral Card Activation 


Polled peripherial cards in the PBox are activated by writing a 
high value (=1) to the first CRU bit of the assigned CRU peripheral 
space. For example, to activate the peripheral card at location 
21500, CRU bit 21500 is turned 'on' (21) via the SBO command. Тһе 
first CRU bit shall be used to enable the data buffer, DSR ROM (if 
used), and indicator LED. СВУ activated cards without 0585 should use 
a CRU bit other than bit O for activation. This bit may be used to 
enable any other chips located on the peripheral card; thereby 
reducing power requirements when the card is not selected. Ап 
indicator LED shall be provided to give the user visual feedback that 
the peripheral card is active; yellow LEDs are recommended for 
consistancy. Тһе CRU bit is not the only enable signal for the DSR 
ROM; see section 3.3. The CRU bit must be latched by a flip flop, 
5259, 9901, or similar device that is capable of storing the status 
of the CRU bit. Provisions must also be made in the design for use of 
the -RESET signal to clear the latch whenever -RESET goes low. 

For non-CRU memory mapped devices, the device must be selected 
only when the assigned address is selected and none of the first bits 
of the 16 peripheral spaces is activated. Circuitry must be provided 
to track the status of the peripheral activation bits, and to deselect 
the memory mapped device if one of these CRU bits is activated. 
Provisions must also be made in the design for use of the -RESET 
signal to clear the non-CRU activation circuitry whenever -RESET goes 
low. 


3.3 Memory Activation 


All memory devices, whether for general storage or memory mapped 
devices, must use address decode circuitry to insure that the device 
will be activated at its assigned address(es). General storage memory 


(at the 22000, 26000, or >А000->Е000 blocks), must be activated by use 
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of upper address lines апа -МЕМЕМ. No CRU bits are required to 
activate general storage memory locations. 

Likewise, non-CRU memory mapped devices, CRU memory mapped 
devices and DSR ROM/RAMs are activated by use of appropriate address 
lines, -MEMEN, and the CRU bus. These devices must be located in the 
24000 to »5FFF address range. DSR ROMs must start at 24000; other 
devices are not required to start at address 24000. 

As noted previously, the READ access time for memory devices is 
650 ns, which is extremely generous, and should allow use of 'LS type 
decoders for use with the /4A system. 


3.4 Miscellaneous Signals 


Peripheral cards must use certain signals to communicate with the 
console and other peripherals. These signals and design notes are 
discussed below. 


3.4.1 READY: System Ready signal 


Used to put the 9900 in a WAIT state during initialization, or to 
extend а memory access cycle for slow memory devices. If used by the 
peripheral card, it must be an open collector driver (like an 'LS125) 
that is tied to ground. Note- activation of the READY signal is the 
sole responsiblity of the individual peripheral and not the console. 
Failure to deactivate the READY signal will result in an inoperative 
System. Note also that this signal is driven out of the card to the 
console. 


3.4.2 -RESET: active low console driven Reset signal 


This signal should be used on peripheral devices to clear the CRU 
activation bit, as well as any other CRU bits, and any other device 
that must be reinitialized to function properly after a low -RESET 
signal. It should be driven into the peripheral by an '1$244 or 
similar chip. 


3.4.3 PCBEN: active high PCB Enable 


This signal is gated with other signals to activate a peripheral 
card. It сап be driven into the peripheral by an 'LS244, or taken 
directly into the PCB with no driver chip. 


3.4.4 -RBDENA: active low Remote Data Bus driver 


-RBDENA must be provided to indicate to the Interface Card that a 
memory cycle (Read/Write) is needed for a peripheral in the PBox. It 
enables the 'LS245 on the console end of the cable. It is recommended 
that an open collector signal ('LS125) or tri-state gate ('LS244) tied 
to ground be used to drive the signal, with the gate controller tied 
to the same signal used to activate the data bus driver. 
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3.4.5 CRUIN: CRUIN signal 


Usually does not have buffer drivers. Signal sent unbuffered 
directly to CRUIN pin of the 9900. 


3.4.6 -LOAD: console LOAD input 


-Load should not be used by a peripheral for the /4A system and 
standard Interface Card. The Interface Card sold by TI did not 
connect the -LOAD signal in the PBox to the console. Use of the -LOAD 
signal assumes use of 32K memory exapansion, since the LOAD interrupt 
vectors are at ОҒҒҒС and >FFFE. Therefore, peripherals for the PBox 
cannot use the -LOAD signal with the /4A system and interface as 
released by ТГ. 

Use of the -LOAD signal is permitted with non /4A systems, or /4A 
Systems modified to properly use the signal. If used, an open 
collector ('LS 125) tied to ground should drive the signal. Note- the 
TI-released disk drive controller drives іле -LOAD signal 
periodically. Апу new peripherals designed to utilize the -LOAD 
signal must either acknowledge the presence (and possible conflict) of 
the disk drive card, or require the user to disable the -LOAD driver 
on that card. TI has stated that the use of the LOAD signal on the 
disk drive controller card was for use with an unreleased console, the 
/4B. 


3.4.7 -INTA: external interrupt to console 


This signal informs the console that the Interrupt Service 
Routine in the peripheral's 058 ROM must be serviced. Тһе signal must 
be driven by an open collector ('LS125) tied to ground. The gate 
controller must Бе activated and deactivated by the peripheral. The 
signal must be activated only when an interrupt is requested. Тһе 
signal must be deactivated only after the interrupt service routine 
has been accessed by the console. 


3.4.8 -SENILA, -SENILB: Interrupt Sense Enable Levels A « B 


Values for these lines are set by the Interface Card as а high 
level (бу). If the peripheral is to be used with a non /4A system, 
utilizing these signals, then -SENILA and -SENILB must be driven into 
the card by an 'LS244 or similar driver. Аз noted earlier, -SENILA 
enables 8 of 16 peripherals to drive one of 8 bits on the data bus 
low, while -SENILB causes the other 8 peripherals to place a unique 
interrupt code on the data bus; this allows the system to rapidly 
identify the peripheral. 

If the Interrupt Sense Enable system is implemented at a later 
date, then each of the 16 polled peripherals may be assigned one bit 
on the data bus for interrupt identification as shown in Table C.2. 
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TABLE С.2 INTERRUPT IDENTIFICATION BITS 





-SENILA Active -SENILB Active 
CRU Data Bit CRU Data Bit 
Address Device Active Address Device Active 
21300 RS232-1 DO »1000 Unassigned DO 
21300 RS232-2 01 21100 Disk drive 01 
21400 Unassigned 02 21200 Unassigned 02 
21600 и 03 21700 " D3 
21500 RS232-3 04 21900 Ч р4 
21500 RS232-4 D5 21800 E D5 
21А00 Unassigned 06 21000 E D6 
»1C00 " 07 »1F00 В 07 


Тһе RS232 positions were established by TI; see section F 2.0 
for details. 


To allow for development of future peripherals with this 
capability from various developers, the following guidelines аге 
recommended: 

1) Identify on the peripheral card and in the documentation that 
the device will utilize the "A" and "B" interrupt sense levels. 

2) Provide a switch or jumper on board to allow the user to 
disable the -SENILA/B circuits. 

3) Provide a switch or jumper оп board to allow the user to 
assign the ID bit to the peripheral to match individual system 
hardware/software needs. 


4.0 Peripheral Polling System 


Several peripheral concepts for the /4A system have been 
discussed in this chapter- CRU-only, non-CRU memory mapped, memory 
only, CRU and non-DSR, and CRU and DSR. Of these, only the last (CRU 
and DSR) is automatically polled by the /4A operating system. Polling 
15 а technique whereby the console will use the CRU bus to activate 
one of 16 peripheral locations in the >4000->5FFF memory block, and 
perform a function. Activation of a peripheral also activates its DSR 
ROM, which contains the software program(s) used with that peripheral. 

As noted in Section I, the peripherals may automatically be 
polled by the /4A under the following conditions: 


1) INITIALIZATION (RESET): Some devices require initialization of 
registers or other functions when the system is first activated, or 
following a software reset. 

2) INTERRUPT: Devices that use interrupts must be polled to 
determine if an interrupt has occured; the interrupt must be cleared 
after processing. 

3) DEVICE ROUTINE: This is the application program that is used 
to make the peripheral work. When requesting a certain device ("PIO", 
etc.), the console will search for the DSR that corresponds to that 
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device and execute the program. 

4) BASIC SUBPROGRAMS (CALLS): Likewise, when BASIC or EXTENDED 
BASIC make subroutine CALLS, the /4A will search the available DSR 
ROMs for the corresponding program. 


In each of the four categories, the /4A operating system performs 
the peripheral polling within the 16 locations defined at 20100 
intervals between 21000 to 21Ғ00. Тһе /4A will search for the 
routine, starting at location 21000. If it does not find what it is 
looking for there, it checks the peripheral at 21100, and so on, 
incrementing the CRU address by 20100 until the peripheral at 21Е00 is 
checked. If no corresponding routine is found, an error message is 
returned. 

Peripheral devices in the other categories are not polled by the 
operating system, and will not be checked automatically (unless 
directed by a DSR in one of the 16 locations that directs the console 
to check a non-DSR device). It is recommended that апу peripheral 
device that requires initialization, interrupts, device routines 
(independent of the 32K RAM space) or BASIC CALL subroutines, be 
placed in a polled peripheral space. 
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1.0 Introduction 


This section is provided to assist the designer with а quick 
reference to integrated circuit chips commonly used in peripheral 
devices for the /4A system. The chips listed are not 'а11' of the 
chips that could be utilized; the designer should have access to data 
books such as "Standard TTL, Volumes 1 + 2", "LSI Logic Book", "ALS/AS 
Logic Book", апа "Interface Circuits Data Book" from Texas 
Instruments. A complete list of logic data books is available from 
Texas Instruments. 

The chips are grouped into four types: drivers, logic, decode and 
CRU. Only basic information is given about the chips. Consult the 
data books for more detailed information, such as power requirements 
and propogation delays. 


SECTION D: TYPICAL CARD CHIPS 


FIG. ТЕЛЕ 
“244 
16 
ea 
1А1-1А 
2А1-2А 


DCTAL DRIVERS 


'e45 


DIR 


С 


А1-А8 


OCTAL TRANSCEIVER 


'e43 
GAB 
GBA 


А1-А4 


QUAD TRANSCEIVER 





PG: D2 
TYPICAL DRIVER CHIPS 
541 

G1 

Ge 
1Y1-1Y3 
CAL-CA4 А1-А8 Ү1-Ү8 

1425/7425 

1A 

eG 2Y 

e 
B1-B8 36 3Y 

3A 

46 4Y 

4 

QUAD DRIVER, INDEPENDENT 

DUTPUTS, ПРЕМ COLLECTOR 

'373 

oc 

C 
B1-B4 1D-8D 10-80 


DCTAL TRANSPARENT 
LATCHES 


SECTION D: TYPICAL CARD CHIPS РС D3 


FIG. Пее LOGIC CHIPS 
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FIGURE. 0.3: DECODER CHIPS 
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1.0 Introduction 


Peripheral devices for the /4A system can vary greatly in 
complexity and function. However, most of them will have to be 
interfaced to the memory bus, CRU bus, or both. The following 
sections present some typical circuit examples to demonstrate how 
interfacing may be accomplished on the /4A system. Аз with Section D, 
Typical Chips, these circuits are not necessarily optimal for all 
peripheral devices, but are presented here as а reference for the 
designer. 


2.0 Memory Interface 


This example shows how a device incorporating the 32K RAM could 
be assembled. Тһе integrated circuits used are summerized below, 
along with their function. This example has address decoding, data 
bus buffering, and generating of the -RDBENA signal; these circuits 
are common with most peripheral devices and are not repeated for the 
other examples. 


Chip Function 

244 address and control signal drivers for A0-15, -WE, DBIN 

245 data bus transceiver for 00-7 

138 decode А0-А2 into 8K chip select banks; selects 22000, 
2А000, »C000 and 2Е000 8K blocks 

21 4 input AND gate, activates the -RDBENA and 245 chip 
enable, inputs are from '138 chip select signals 

04 1 of 6 hex inverter, used to convert DBIN to -DBIN (-0Е 
for 8K RAM and 245) 


3.0 CRU Interface 


CRU interface can be implemented rather easily with relatively 
common chips. Figure 3a shows how an 'LS259 is used to latch up to 8 
individual CRU bits. The 'LS138 is used as an address decoder, while 
-CRUCLK is used as an enable signal (to prevent activation during a 
normal memory bus access). The 8 individual bits are selected by 
address lines A12-A14, and the CRUOUT line inputs the value of the bit 
(0 or 1). The -RESET line clears all the bits when the system is 
reset. The !15259 is used in the Latch mode which means that the 
value of the CRUOUT line at the time of access is held constant until 
it is either rewritten or reset. Software must be written to insure 
that CRU bits are not accidently left on when a peripheral device is 
no longer accessed. 

Figure 3b demonstrates how to input data via the CRU bus. Once 
again, the 115138 is used for address decoding. Тһе 115251 is used as 
a 1 of 8 data input, with address lines A12-A14 selecting the input 
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line. Once the line is selected, the CRUIN line reads the value (0 ог 
1). The -CRUCLK signal is not used, since it is for data output by 
the CRU bus only. Data at the 8 inputs to the 'LS251 must be valid 
before being read by the CRUIN line. 

The most versatile, and often underused, chip for CRU interfacing 
is the TMS9901. The 9901 can provide 6 dedicated interrupts, 7 
dedicated 1/0 CRU bits, and 9 lines that can individually be 
programmed as either interrupts ог 1/0 bits. [п addition, it has a 16 
to 4 interrupt prioritizer (which is not used in peripheral designs 
for the /4A, due to the limited interrupt structure), and а built-in 
programmable timer that can be preset to interrupt at a specified 
interval. Figure 3c shows the basic interconnect for a 9901 to the 
PBox bus. Address decode circuitry selects the chip, while the full 
CRU bus is directly connected to the 9901. Тһе lower address bits 
A10-A14 are used to select the 1/0 and interrupt pins. When ап 
interrupt occurs, the -INTREQ line drives the -XINT line low, and it 
is up to the software to read the interrupts internally to determine 
which one was active. -CRUCLK must be inverted back to positive 
CRUCLK for the CRUOUT line to function properly. 


4.0 Memory mapped interface 


Memory mapped decoding is similar to regular memory interfacing, 
in that various address lines are used to select a particular device. 
In Figure 4a, two 'LS138s are used to decode the 6 most significant 
address lines. With this scheme, the second '138 provides 8 select 
lines that will activate individual 1K blocks. These 8 1K blocks 
reside within the 8K block chosen by the first '138 decoder. When 
used іп a polled peripheral, this 8K block would be >4000->5FFF. CRU 
decoding is used to select the peripheral space and activate the 
device (or 058 ROM) only if both the address is valid, and the first 
CRU bit in the CRU peripheral space is set. 

Figure 4b also uses two chips, but can decode all 16 bits to an 
individual address. The first '688 compares the first 8 MSB (A0-A7) 
to a value set by an 8 switch DIP set. When these 8 bits are equal, 
they enable the second '688, which does a similar comparison for the 
lower 8 address bits. Тһе second '688 produces a low true signal when 
the 16 address bits equal the value set on the DIP switches. Once 
again, this is gated with the appropriate CRU bit to activate the 
peripheral. 

The non-CRU memory mapped decode circuitry is more complex, as 
shown in Figure 4b. Once again, ап 'LS138 is used to decode А0-А2 То 
enable the 24000 8K block. The 'LS154 further decodes A3-A7 into all 
16 possible polled peripheral locations (>1000->1F000). All 16 
outputs are routed to two 'LS21s (4 input AND gate) which are 
connected such that the final AND gate output goes low if any of the 
16 inputs goes low. This, along with other signals is latched by a 
259. This circuit will provide a master output signal, -Qo, that 
follows the following logic: 
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IF -Qo is Тои THEN а polled perpiherial is active and the non-CRU 
memory mapped device CANNOT BE ACTIVE. 


IF -Qo is high THEN no polled peripheral is active 


and the 
non-CRU memory mapped device CAN BE ACTIVE. 


This circuit must be combined with other address decode circuitry 
to select the peripheral within the 24000 block. 
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FIG. Ег: MEMDRY INTERFACE EXAMPLE 
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FIG. Е.4: MEMORY MAPPED EXAMPLE 
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SECTION F: TI DEVELOPED CARDS 


1.0 Introduction 


Texas Instruments developed and sold 4 cards for the peripheral 
expansion box: the RS232, 32K memory, disk drive controller and P-code 
card. Reference 4, the Bunyard Manual, has a very detailed 
explanation of how each of these cards are put together. For purposes 
of comparison of design methodology (this document vs. TI), a brief 
description of the interface circuitry for the RS232, 32K memory and 
disk drive controller is provided. 


2.0 RS232 card 


1152445 are used to drive А0-А15, AMA-AMC, -CLKOUT, -MEMEN,  -WE, 
-CRUCLK and DBIN. An 'LS245 is used for 00-07, with DBIN determining 
the data flow direction. Ап 115125 is used to drive pin 17, -XINT, 
and -RDBENA. CRUIN is brought on the board unbuffered, as well as 
PCBEN. The majority of the address decode is done by a Programmable 
Array Logic (PAL) chip. On the RS232, as well as the other cards, 
that AMA-AMC and PCBEN must be active high to select the card. Тһе 
RS232 card can also drive DO and 01, ог 04 and 05 if an interrupt 
occurs, and -SENILA is brought low. The Bunyard Manual notes that the 
CRU address of the card can be changed by moving one resistor. 


3.0 32K memory card 


'LS244s are used to drive А0-А15, AMA-AMC, -MEMEN, and DBIN. 
Neither CRUCLK or -WE are used by this card. -RDBENA is driven by ап 
5125 when the card is selected, and an 'LS245 controls the data оп 
00-07, with DBIN controlling the direction. Тһе interesting item оп 
this card is the lack of use of the -WE signal. А PAL controls the 
32K worth of dynamic RAM, which is much more complicated than need be 
if static RAM were used. Also, РСВЕМ is not used in the decode logic. 


4.0 Disk drive controller card 


Once again, 'LS244s drive А0-А15, -МЕМЕМ, -МЕ, -CRUCLK, DBIN, 
AMA-AMC, and -CLKOUT. РСВЕМ and CRUIN are unbuffered, as well as 
-RESET. Ап 115245 carries the data оп 00-07.  -RDBENA and READY are 
driven by ап 'LS125. А PAL is used for most of the address decode 
logic. The disk drive controller does not drive -XINT, but does have 
an active, but unused interrupt signal -INTRQ. This originates from 
the WD1771 controller chip, and is connected to pin 18, -LOAD on the 
PBox bus. Ап 'LS125 also drives DO low if -SENILB is Том. 
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SECTION 6: PERIPHERIAL LOCATION ASSIGNMENTS 
1.0 Introduction 


As noted previously, there are 16 CRU defined locations available 
for peripherals for the /4A system. ОҒ these 16, four locations are 
assigned to existing products released by TI. Other locations were 
reserved by TI, but the planned peripherals were not released. Table 
G.1 lists the 16 peripheral spaces by their CRU address, indentifies 
the address values to decode that space, and defines the assignment of 
all spaces. The functions were arbitrarily assigned, but were done so 
to help developers determine where their product should be located in 
the peripheral space, thereby minimizing conflicts between different 
devices. It is recommended that peripheral developers include 
circuitry on their devices (similar to the examples in Section E) to 
allow the user to select the CRU location for the device in their 
individual systems. While this design feature could result in 
conflicts between two devices accidently assigned to the same 
peripheral space, it does allow maximum flexibility for the end user. 
Any documentation accompanying the device should clearly identify the 
recommended CRU location. 

The space assignments are choose to correspond with individual 
peripheral products currently available with various computer systems. 
Availability of any peripheral product listed in Table G.1 is 
dependent upon the efforts of the hardware developer, and does not 
necessarily imply that such a product exists, or will at a later date. 
Two peripheral spaces are left undefined to allow for prototype 
projects, or future devices whose function is not clearly defined 
elsewhere in Table G.1 
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Table G.1 
Peripheral Location Assignments 
Addr. Established Assigned 
Peripheral Space Lines Function* Function Notes 
ЕЕЕЕЕЕЕЕЕЕ=======А3456 7 =====================Е=ЕЕЕ=ЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕНЕЕЕЕЕЕЕЕЕ 
21000-210ҒЕ 10000 - mass storage 1 
21100-211ҒЕ 10001 disk controller disk controller 
>1200->12FE 10010 (home security) math coprocessor 2 
21300-213ҒЕ 10011 85232-1 RS232-1 
21400->14ЕЕ 10100 (internal modem) internal modem 3 
21500-215ҒЕ 10101 RS232-2 RS232-2 
21600->16ЕЕ 10110 (digital cassette) prototype low 4 
21700-217ҒЕ 10111 Hex Bus attached computer 5,6 
>1800->18FE 11000 thermal printer MIDI/music . 5,7 
>1900->19FE 11001 (eprom programmer) programmer 8 
>1A00->1AFE 11010 (student typing) speech/DSP 9 
21800->1ВЕЕ 11011 (debugger card) Utility card 10 
21С00-21СҒЕ 11100 video video 
»1D00-»1DFE 11101 IEEE 488 control real time clock 5,11 
21Е00->1ЕЕЕ 11110 - prototype high 4 
>1FOO-> 1FFE 11111 P-code P-code 


*Items in parenthesis denote third party or unreleased TI 
devices. 
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Table 6.1 Notes 


1) Mass storage is currently defined as RAM disks, but also 
includes other media such as CD-ROM. 

2) Position 21200 is reserved for high speed math coprocessors, 
which may be interrupt driven and require quick response times. 

3) An internal modem is defined as a standalone peripheral with 
direct connection to telephone lines, with no interface to the RS232 
devices. 

4) Prototype locations (low and high) are left undefined for 
prototype circuits and undefined future products. 

5) These card positions were defined by TI; however, the 
peripheral either was not released, or is seldom used. Therefore, 
this peripheral space was reassigned. | 

6) Attached computer or microprocessor refers to a self contained 
computer system with its own microprocessor. This space can also be 
utlitized for interfacing to independent computers. 

7) This space is reserved for electronics music devices. 

8) This space is reserved for programmers of various devices, 
such as PROM, E(E)PROM, PAL, etc. 

9) This space is reserved for speech and/or digital signal 
processing devices. 

10) A utility card refers to peripherals designed to enhance or 
supplement development of аззем Бу or other advanced program 
applications. 

11) Real time clock peripheral space; also used as RTC space by 
some third party products. 
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SECTION H: MISCELLANEOUS DESIGN CONSIDERATIONS 


1.0 PBox Peripheral Card Dimensions and Layout 


Figure Н.1 gives the physical dimensions of a printed circuit 
board designed to fit in the /4A PBox. These dimensions are taken 
from the prototype board, and assume that the card will be bare (ie- 
will not use a 'clamshell' cover like the original TI cards). These 
dimensions are extremely useful for designers who are planning to 
produce PCBs for kits or final projects, or for the hobbiest who 
constructs his or her own one-of-a-kind PCBs. The extension section 
in the rear is optional, and is designed to extend outside of the 
PBox; it is not needed unless external connections are used by the 
card. Positioning of the indicator LED is relatively critical - it 
must line up with the built-in lens of the PBox to give the user a 
good strong light signal. 

Drivers and buffers must be physically located as close to the 60 
pin edgeboard as possible. Unregulated 48V, +16V, and -16V аге 
provided at opposite ends of the card for input to voltage regulators. 
If the +16V and -16V pins are not used, it is recommended that their 
edge connectors not be put on the PCB. This will eliminate accidental 
shortage of the unregulated voltage with adjacent signals, such as 
-MEMEN. Voltage regulators may be mounted directly to the PCB for 
heat sinking purposes. Voltage regulators should have heatsinks with 
heat sinking compound in most designs, particularily if the circuit 
draws more than one-half of the rated output of the regulator. 
Regulators should also have enough de-spiking capacitors to ensure 
reliable performance. 

Layout of other components on the PCB should not be critical. 
PCB traces with signals or power feeds should not be routed near the 
front or back, where they could accidently short to ground against the 
PBox chassis. А11 РСВ areas not utilized for traces should be left 
unetched (1е- solid copper), and tied to ground to act as а ground 
plane, and minimize external signal interference. Any connecting 
hardware such as plugs, sockets, etc., that will have cables inserted 
and removed should be bolted to the board to prevent damage to the PCB 
from repeated insertion/removal. 

Each peripheral card should not use more than the following 
maximum power on the three unregulated power buses: 

500 ma on 8V 

250 ma on 16V 

30 ma on -16V 

This is a function of the PBox power supply, split over a maximum 
оҒ seven cards. [+ more power is required by an individual card, ап 
independent power supply with common ground should be used. 


2.0 Prototype Board 


Designers wishing to test their peripheral circuits prior to 
manufacturing PCBs can utilize a prototype PBox board, which is 
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currently available from LL Conner Enterprises. This is a wire wrap 
type board with all signals brought on board from the bus, and 
positions for bus drivers and buffers provided. Multiple positions 
for memory and general purpose chips are also provided, as well as for 
the voltage regulators. 

If the prototype board is unvailable, then prototypes can be 
constructed from breadboard/wirewrap board with a 60 pin plug that is 
compatible with the PBox bus (TI part # L21111121-30). 


3.0 Extender cable 


Access to circuit boards installed іп the PBox is extremely 
limited. To facilitate easier testing and troubleshooting of 
prototype devices, the hardware designer may wish to construct a bus 
extender cable. А bus extender cable may be constructed by connecting 
a 60 pin edgeboard plug to a 60 pin edgeboard connector (0.1" pin to 
pin spacing for both) with two 30 conductor ribbon cables. А maximum 
of two feet of cable is usually desirable to allow for ease in placing 
the prototype card in a convenient location. Use of shielded cable is 
recommended to minimize EMI/RFI interference. 


4.0 Modified Interface Card 


As noted in several previous sections, the Interface Card sold 
with the PBox limits the use of some signals in the PBox bus. Figure 
H.2a is a simplified diagram of а modified interface card that 
duplicates the function of the original interface card, but also 
allows use of some of the restricted signals. 

AMA-AMC, -SENILA/B, and HOLD are connected to +5V via resistors, 
but also have a DIP switch set that allows these lines to float 
(neither +5V or ground), like SCLK, IAQHA, etc. PCBEN must be held to 
5V to allow the TI developed cards to operate, and does not have a 
switch. -LCP is tied to the chip enables for the address and data 
drivers such that a low value will disable the interface card. The 
design shown in Figure H.2a would be useful in implementing a system 
that has an independent computer/microprocessor in a peripheral space 
that occasionally takes over the PBox bus from the /4A. Software 
between the two systems would be responsible for disabling and 
enabling the interface card. [This system would not be required if 
HOLD and -HOLDA were available at the /4А 44 pin side port. ) 

A slightly different design for the interface card is shown in 
Figure H.2b. Here, signals such as AMA-AMC, -SENILA/B, etc., are 
taken to the console end of the interface cable, where ап undefined 
'black box' is used to generate signals under software control. As ап 
alternative, the black box circuitry could be on the interface card in 
the PBox. This design assumes the /4A will generate all new signals. 
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FIG. Нед: MODIFIED INTERFACE - INDEPENDENT MICRO IN РВОХ 
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SECTION I: DSR ARCHITECTURE 


1.0 Introduction 


This section briefly covers the software required to make 
peripherals compatible with the /4А and its File Management System 
(FMS). Software for a standard peripheral is referred to as a Device 
Service Routine, or DSR. Section I discusses the basic parts of a DSR 
and gives coding examples. Section J examines how the console 
accesses DSRs. Section K contains miscellaneous information on direct 
access of peripherals and the non-DSR peripherals from a application 
program, апа information оп Peripheral Access Blocks (PABs) and how 
they interact with DSRs. 


2.0 Device Service Routines 


Device Service Routines are included on many peripherals to allow 
the /4A to communicate with the device(s) located on the peripheral. 
To simplify the addition of new peripherals, the /4A has a defined 
protocol for interaction with peripherals during inital powerup, 
interrupts, and main device programs. Peripherals may also add new 
subprograms (CALL XXX) to BASIC and XBASIC. Тһе /4A communicates with 
each peripheral in exactly the same manner; it is up to that 
peripheral's DSR to define how the peripheral operates. This way, new 
peripherals may be added without altering the console routines. More 
information оп the /4A and its File Management System can be found in 
the Editor/Assembler manual, or /4A Peripheral Technical Data manual. 

DSRs can be located in either GROM or ROM (PROM, EPROM, EEPROM, 
battery backed SRAM) devices. Since GROMs are beyond the scope of 
this manual, further discussion of 0585 will be limited to ROM-type 
applications only. 0585 can be composed of several different kinds of 
routines, depending on what functions the peripheral is to perform. 
Six types of DSRs are defined: power up, user application, main device 
service, subroutine links, BASIC subprogram libraries, and interrupt 
Service programs. The /4A finds and executes these programs by 
searching the ROM header, which is in the first 10 bytes of the ROM. 
The console identifies valid DSR ROMs by checking that byte O is "AA". 
(Note: non-DSR peripherals may have applications programs іп ROM at 
the same location, but must be called by an independent program in the 
console, and must not have the validation byte (0) set to "AA".] Byte 
1 contains the version number of the DSR. The remaining bytes in the 
header identify the entry points for the various programs used by the 
DSR. Table I.1 identifies the contents of the DSR header. 


Table I.1: DSR Header 





Location Size Contents 

24000 byte 2ДА valid ID 

4001 byte version number 

4002 byte number of application programs, set to zero 


4003 byte reserved, set to zero 
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4004 word address of first power up header 

4006 word address of first user program header* 

4008 word address of first main device header 

400A word address of first subroutine link header 
400C word address of first interrupt link 

400E word address of first BASIC subprogram library* 


{*Only in GROM or at 26000 location] 


The address of any routine types should be 20000 in the ROM 
header if there are no routines of that type in the DSR. Тһе number 
of application programs and version number values (bytes 1 and 2) are 
ignored by the /4A system. Program entry addresses may be placed 
anywhere within the 24010 - »5FFF range, and multiple routines рег 
program type are allowed (ie- there may be more than one main device 
routine, interrupt, etc.). The address of the program type given іп 
the header is the link to the next routine of that type. At the first 
address is the linking address of the next routine; the word 
immediately after this address is the entry point of the first 
routine. If the linking address is zero, then no more routines of 
that program type are available. See Examples I.1 - 1.5. 

Not all peripherals require all types of routines; it is up to 
the designer/programmer to determine which routines the peripheral's 
DSR will require. Аз noted in Table 1.1, there are four types of 
programs available for DSRs in ROMs: power up, interrupt, main device 
routine and subroutine link [also referred to as BASIC CALL (sub), or 
low level routines]. These program types are discussed next. 


2.1 Power up routines 


Some peripherals require intialization upon power up or following 
a system reset. Or a power up routine may be included simply to flash 
the peripheral indicator light to let the user know that the device is 
active. Іп either case, they will require a power up routine іп the 
DSR. The /4А initializes the console upon power up, then searches and 
executes all peripheral DSR power up routines. 

Each power up routine can use RO-R10 of the GPLWS. R12 will be 
set up with the proper CRU address for the peripheral (which is also 
the CRU address used to enable the peripheral). R11 contains the 
return address. R13 апа R15 contain the memory mapped addresses of 
СКОМ Read Data and VDP Write Address, respectively. А11 VDP and СВОМ 
operations can be indexed from these two registers. R14 contains the 
status flags and should not be altered. The power up routine may use 
VDP RAM from 20000 to the address pointed to by 28370 [note that the 
VDP and its memory are not completely initiated at this point]. It 
may also use all console scratch pad RAM except 28355-28360 апа 
>83C0->83DF. Errors are not assumed to occur during execution of 
power up routines, and there are not provisions in the FMS for 
identifying power up errors. The power up routine may print ап error 
message on the title screen to let the user know of a problem with the 
peripheral. If there are no errors, the power up routine returns with 
а В *R11. 
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PU1 


PU2 


PUTEN 


PU2EN 
EXIT 


13 








EXAMPLE 1.1: POWER UP ROUTINES 


AORG 24000 
BYTE ЗАА 
BYTE 1 
DATA 0 
DATA PU1 


DATA PU2 
DATA PUTEN 
BYTE 0 
EVEN 

DATA 20000 
DATA PU2EN 
BYTE 0 


start of DSR 
validation byte 
version number 
reserved 

first power up link 


link to second power up 

entry point of 15% power up routine 
name length, set to zero 

reset pointer to word boundary 

no more power up routines 

entry point of second power up 


entry of 1st power up routine 
entry of 2nd power up routine 


return to console 
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2.2 Interrupt routines 


Interrupt routines are required for peripheral devices that 
generate interrupts, and are connected to the -INTA line. Since the 
/4A system scans all peripheral interrupt routines to determine which 
DSR caused the interrupt, the DSR must be capable of checking the 
peripheral to determine if it generated the interrupt. The interrupt 
routine must clear the interrupt when the routine is complete. 
Generally, peripheral devices will generate their own -INT signal, 
which is cleared by DSR software. Other designs may incorporate a TTL 
latch or flip flop that is cleared by CRU or other signal. Іп any 
case, the -INT line must be cleared prior to exiting, or the console 
will continue to branch to that interrupt routine indefinitely. Тһе 
flow diagram for the interrupt program logic is shown in Figure I.1. 

The interrupt routine can use R1-R10 of GPLWS, except for R9. 
The contents of R13 - R15 are the same as for the power up routines; 
R11 contains the return address. Because of the execution of an 
interrupt routine only as part of a DSR, the DSR and interrupt routine 
can split the allocation of scratch pad RAM from >834A to 28360. Ап 
interrupt routine is always exited by a B *R11. Аз with power up 
routines, no provisions are made for reporting errors that occur 
during an interrupt routine. 

The RS232 card as released by TI assumes that no other peripheral 
will cause an interrupt while it is in use. Interrupt driven 
peripherals must have routines that either acknowledge this feature, 
or can function around the RS232 card. Refer to the RS232 interrupt 
routine as disassembled and commented in "Technical Drive". 
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FIO qp INTERRUPT ROUTINE 












Is the -INT low for 
this peripheral? 


execute interrupt routine 


clear interrupt signal 








return 
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EXAMPLE 1.2: INTERRUPT ROUTINE 

AORG 24000 
BYTE >AA 
BYTE 1 
DATA 20000 
DATA ----- powerup routine 
DATA »0000 
DATA ----- main device routine 
DATA ----- subroutine link 
DATA INT1 1st interrupt link 
DATA 20000 

INT1 DATA INT2 link to 2nd interrupt routine 
DATA INTEN1 entry point of 1st routine 
BYTE 0 name length set to zero 
EVEN reset WP 

INT2 DATA 20000 no more int. routines 
DATA INTEN2 entry point of 2nd routine 
BYTE 0 
EVEN 

INTEN1 entry of 1st device 


ІМТЕМ2 


CLEAR 


END 


$ 
[reset -INT signal] 


[check for interrupt; if none go to END] 
[interrupt service routine] 

[go to CLEAR] 

$ entry of 2nd device 
[check for interrupt; if none go to END] 
[interrupt service routine] 

[go to CIEAR] 


clear interrupt 


B *R11 return 


РС 


16 
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2.3 Main Device Routine 


The Main Device Routine(s) defines the function(s) of the 
peripheral, and must be included on all peripherals with devices to be 
accessed. А5 with the power up and interrupt routines, there may be 
multiple main device routines for one peripheral, such as for the 
R$232 card. Main device routines are called via the File Management 
System in the BASIC/XBASIC environment, which establishes PABs іп VDP 
memory for each opened file. The device name is located in VDP RAM, 
and is pointed to by a word value at 28356. Тһе device name апа 
character count byte 15 also included in the PAB. The main device 
routine is called by either the File Management System, or by  DSRLNK 
in an applications program. 

R12 will contain the CRU address of the peripheral being 
addressed, and R11 contains the return address. Registers RO-R10 can 
be used by the routine as well as 2834А -28360. If an error occurs, 
the DSR must set the error codes in the PAB, as defined in Section K, 
and perform a B *R11. If no errors occur, the routine must increment 
R11 by two prior to exit. However, if the peripheral is not 
interested іп responding to the call (ie- the same device name may be 
on more than one peripheral), it may return via B *R11. 

The main device routines often require extensive coding due to 
numerous housekeeping responsibilities that they must perform. These 
responsibilities include: 


1) Maintain interface with FMS 

Device routines are accessed in terms of files and records. [See 
Section 18 ОҒ the Editor/Assembler manual]. Тһе designer/programmer 
must determine what data format(s) is appropriate for interfacing with 
the FMS. Changes to the 1/0 status of a peripheral must also be 
handled by the device routine. 

2) Respond to STATUS 1/0 opcode 

As noted in Section K, the DSR should be capable of responding to 
a STATUS 1/0 request by updating byte 8 of the PAB. This byte is used 
to determine the current status of the peripheral. 

3) Report any errors 

The DSR also reports errors that occur during processing of main 
device routines before returning. Section К defines the error codes 
and their meaning. Errors are reported in the FLAG byte of the РАВ. 

4) Maintain device housekeeping 

The DSR must also tend to any requirements of devices located on 
the peripheral while active. The DSR must also properly disable the 
device prior to terminating access. 


The basic flowchart for a main device routine is given in Figure 
I.2. It is based upon a review of the CLOCK, RS232, and Disk Drive 
Controller DSRs. The programmer is responsible for determining what 
I/0 opcodes are used with the peripheral, and developing the 
appropriate code. Example I.3a is a typical main device routine 
example. Example 1.35 is the disassembled and commented DSR for the 
CORCOMP 9900 Clock card (from "Technical Drive", by Monty Schmidt, 
reprinted with permission). The programmer may consider using a 
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similar structure in developing main device routines for new 
peripherals. Тһе programmer 15 strongly encouraged to review the 
disassembled and commented RS232 and Disk Drive Controller DSRs given 
in the manual "Technical Drive". 


{ 


devices wit 


storage onl 
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FIG. 1.2: MAIN DEVICE ROUTINE 














HEADER 
validation byte/version 
# prgms/reserved 
powerup 

user program 

main device 

subroutine link 
interrupt 

BASIC subprgm library 
















main device 1 
main device 2 
etc. 











MAIN DEVICE 
store GPLWP 

save return address 
copy PAB into BSR RAM 
set FLAG bits 0-4 













check op-code: does 
this device use this 
op-code? 





jump to op-code routine 








OPEN (recover options) 
^? READ 

>3 WRITE 

24 RESTORE/RE WIND 

25 LOAD 

26 SAVE 

27 DELETE 

28 SCRATCH RECORD 
STATUS 











›1 CLOSE ERROR 

write FLAG byte to VDP set error bit in 
RAM from DSR FLAG byte 

write character count 
byte to VDP PAB from 
DSR RAM (if a READ op.) 
РИ = ВИ + 2 
return ма R11 


PG 


|9 
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0581 


DSR2 


DSREN1 


DSREN2 


ERROR 


OKEND 





EXAMPLE I.3a: MAIN DEVICE ROUTINES 


AORG 24000 
BYTE >AA 
BYTE 1 
DATA 20000 
DATA ---- 
DATA 20000 
DATA 0581 
DATA ---- 
DATA ---- 
DATA 20000 


DATA 0582 
DATA DSREN1 
BYTE 4 

TEXT ЕМ!" 
EVEN 

DATA 20000 
DATA DSREN2 
BYTE 4 

TEXT 'DEV2' 
EVEN 


і езі өзі 


$ 


[set error bits] 


B *R11 


$ 
INCT R11 
B *R11 


link to 1st device routine 


link to next DSR 

entry point of 1st device 
name length of 1st device 
name of 1st device 


no more DSRs 
entry to 2nd device 


name length of 2nd device 
name of 2nd device 


entry point of device 1 


entry point of device 2 


entry point of error reporting routine 


do not increment R11 


no errors return 
increment R11 by two 
return 


I: DSR ARCHITECTURE 











EEK 5 ЭЕ УЕ ЭЕ ЭЕ ЭЗЄЗЕ ЭЕ Ж ЭЕ ЖЕ ЗЕ ЭЕ HEL ЭЕ ЭЕ Ж ЭЕ ЭЕ ЭЕ Ж ЭЕ Ж ЭЕ ЭЕ ЭЕ ЭЕ ЖЕ ЭЕ ЭЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ IO ЭЗЕ ЭЕ ЗЕ ЭЕ ЭЕ УЕ ЗЕ EK HK HE HH HK Ж ЭЕ EK 


ж жож OK OK ж ж 


ЗЕЗЕЗЕЗЕЗЕЗЕ ЗЕ ЗЕЗЕЗЕЗЕЗЕ ЗЕ ЗЕЗЕЗЕЗЕЗЕЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ C ЭЕ ЭЕ ЗЕ ЗЕЗЕЗЕ ЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЗЕЗЕЗЕЗЕЗЕ ЗЕ ЭЕ ЭЕ ЗЕЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЄ ЭЕ ЗЕ ЭЕ ЭЁ ЭЁ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕЗЕЗЕЗЕЗЕ Ж ЗЕ ЗЕ ЗЕ 


4808 
ча82 
4604 
адав 
408 
авад 
звес 
499Е 
4019 
4912 
4914 
4016 
4918 
481А 
391С 
4@1Е 
4928 
4022 
4824 
40926 
4628 
402A 
492С 
402E 
403g 
4952 
4434 
4436 
4258 
403A 
493C 
4g3E 
4046 


4042 


4844 


4946 


4848 


адал 


адас 


4д4Е 


49058 
4852 


ААд1 

eogg 
4938 
дада 
403E 

авва 
абда 
адаа 
946g 
азас 
2845 
2928 
434F 
5059 
5249 
4748 
5429 
3139 
5835 
2842 
5929 
434Е 
5245 
акар 
5агс 
2049 
4E43 
2Е09 
дао 
4662 
веда 
даға 
ада 


0543 


4C4F 


434B 


8113 


авада 


заса 


1848 


6gteg 
2C2F 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
TEXT 


TEXT 


EVEN 
DATA 
DATA 
DATA 
DATA 
DATA 
BYTE 
TEXT 


BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
TEXT 


Source code for CQRCOMP 99808 Clock card 


Dissassembled and commented 3/20/86 


by Monty Schmidt 


>AADA 
IJJI 
24958 
JID 
2483Е 
29886 
289955 
29963 
2946565 
2434C 
" (С) COPYRIGHT 


> ВУ CORCOMP, 


звева 
24862 
ISAS 
завве 
»48A4 
285 
'CLOCK" 


201 
>13 
ав 
284 
258 
са 
219 
^48 
^68 
^E 


1985” 


INC." 


жж 
жж 
жж 
жж 
жж 
жж 
** 
жж 
жж 
жж 


ж 
ж 
ж 
ж 
ж 
ж 
ж 


Valid DSR identifier and version 
Not used in DSR calls 

Address of Power up link 

Not used in DSR calls 

DSRLNK address 

Not used in DSR calls 

INTLNK zero, no interrupt rtn. 
Not used in DSR calls 

222? Test routine perhaps 

Points to infinite loop Test rtn? 


Linkage set to 8: only 1 power up 
Entry point of power up routine 
Name length set to 8 

Linkage to next device field-none 
Entry point of device 

Name lenath of device 

Device name 


Number of characters to read 
Mask byte for write 

Maximum allowable opcode 
ASCII offset *or numbers 
Enable byte 


Mask byte for write 
227902222227? 


Mask for status and enable byte 
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4854 ЗАВ EVEN 

4056 ПЯВА DATA 19 ЖЖ Constants for write routine 

4958 9884 DATA 4 жж 

405А 4ØF2 DATA >40Е?2 *x Open routine address 

485С 4080 DATA »4982 жж Close routine address 

405E 923A DATA »423A Xx Read routine address 

38649 4134 DATA »4134 *x Write routine address 


жж Power up routine ЖҰЖ 


4062 C18C MOV  R12.R6 ** Сору CRU address into Ró 
4064 045В RT ** Return 


жж Error Codes ЖЖ 


4266 9291 LI R1,>4888 ** Bad Open Attribute 
4068 4000 
406A 1008 IMP %+›12 »407C 
486C 0281 LI К!. 7269989 ** Illegal Operation 
406t 6009 
40780 1885 JMP ъ+ >8С ^»4907C 
4072 6281 LI R1,»580098 жж Out of Table or Buffer space 
49074 82382 
4076 10492 IMP  $*»5496 »4907C 
4978 926! ЕТ кі, усеве жж Attempt to read past end of file 
457A CISS 
407C F981 SOCB R1,Q»5FFóB(R4) ** Set Status Bit in DSR area 
47E FFóB 


ЖЖ Close Opcode Routine ** 


4888 бода BL 8541112 *X Set up address to PAB Status Bvt 
4882 4112 


4084 4991! DATA 24901 

4986 DBES MOVB @>OFFS6B(R4) .@>FFFE(R15) ** Write DSR Status Byte to VDP РА 
4088 FF6B 

498A FFFE 

408C JAD BL 824112 ** Set up address to РАВ Char count 
408E 4112 

4898 4005 DATA >4005 

4892 ОВЕ4 MOUB @>FF6F(R4) ,@>FFFE(RIS) XX Move DSR char cnt to PAB char c 
4894 FF6F 


4996 FFFE 

4098 05Е4 INCT е)» РРВо (ка) Жж INCT the return address 

489A ЕЕВ5 

489C 84C8 CLR RS 

409Е С2ЕЗ MOV  QG»5FF86(R4),R11 ЖҰ Move return address into Ril 
49А8 FF86 

48А2 045В RT ЖЖ and ао back! 


** DSR Routine ЖЖ 


46А4 92А4 STUP R4 ** Store GLPWSP pointer in R4 

4046 C9dB MOV  R11,G»5FF86(R4) ** Save return address in DSR area 
4GA8 FF86 

SSAA C184 MOV R4A,RG * Move GPLWSP pointer into КО 
480AC 0226 АТ Ró, >FF78 ** Make it point to 58558 of DSR 


4dAE FF78 ЖҰЖ area 








34988 9285 LI RS, 20597 *x Clear out 7 words of the DSR area 


4882 8887 
4884 9466 CLR *Ró+ 


4986 06095 DEC RS қ жж Done yet? 

4888 16FD JNE  $-»5604 »4dB4 ** Mope?, do it again 

40BA 8546 BL 824112 ** Set VDPWA to beginning of РАВ 
аввс 4112 

4SBE 99960 DATA >0000 

дасо 285 LI RS, >200А ХХ We're aoing to get 16 bytes 

40C2 ЯВЯВА 

4664 C184 MOV R4G,RE ХХ Put GPLWSP іп Ко 

40Có6 0226 AI Ré,»5FF6A ** Point to DSR area in Scratch Pad 
40C8 FF6A 

SSCA DDAF MOVB G»5FBFE(R15)0,XR6* XX Move byte from РАВ to Scratch Ра 
48CC FBFE 

40СЕ 0605 DEC RS ** Done Yet? 

4808 16FC JNE +->66 >4BCA ЖЖ nope?, Do it again 

3902 5920 5652СВ QG»49051,Q»5FF6B(R4) ХХ Clear out bottom 5 bits of stat 
4804 4951 ** byte. Set to defaults 

4806 FF6B 

3465108 9824 СВ G»FF6A(RA),Q0»404B Жж Is this valid opcode? 


48DA ЕРФА 
480DC 4848 


ОЕ 1292 ЗЕ %+›д& »40E4 ** Yes, then keep aning 

480EO 0460 В @›аб&сС Xx Море!, Return an error 

40E2 486С í 

494 0164 MOVB QG»5»FFó6A(R4).RS жж Put opcode in MSbyte of RS 
40Е6 ЕРФА 

а8ЕВ 0985 SRL 5.8 - жж Put it in low byte 

40EA SAIS SLA R5,1 ** Multiply it by 2 

44SEC C165 MOV 0>405А(Б5).Р5 ** Get address from opcode table 
4g9EE 405A 

доғо 9455 В *RS XX Jump to the correct opcode rtn. 


** Open Opcode Routine ЖЖ 


авЕ2 DOA4 MOVB @>FF6E(R4) , R2 ж+ж Move @ DSR Logica! length 

484 FF6E 

40F6 1699 JNE 5+ 214 >41 ØA ** If its not Ø then don't alter it 
доға ЗАЗ BL @>4112 жж Set up VDP pointer to logical 
ABFA 4112 ** length 

4SFC 4004 DATA 44994 

4GFE 9292 LI Е2,>1300 ҰЖ 19 Chars for length 

4100 13060 

4102 0982 MOVB R2,G0»5FFó6E(RA4) ** Put it іп DSR logical length byt 
4104 FF6E 

4106 DBC2 MOVB R2,G»5FFFE(R15) ** Put it in PAB logical length byt 
4188 FFFE 

410A 0064 MOVB QG»5FF6B(R4),R1 XQ Move status byte to Ri 

419С FF6B 

4Я10Е 0460 В ез 4еве **x Return 

4110 49080 


** This routine sets up the VDPWA for a read or write from the PAB. 
X* data statement is passed and used as follows: 248 in MSByte is a 
ЖЖ write, 200 is a read, LSByte is offset into РАВ. 


4112 C864 МОУ G@>FF76(R4),RI ** Put device pointer in В! 
4114 FF76 
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4116 6064 5 Q»FF74(R4),R1 
4118 FF74 

411A 0221 AT Н1, >ЕҒЕ6 

411C ЕЕЕФ 

411E А97В А XR11*,R1 

4120 D7E4 MOVB е» 8895 (84), #815 
4122 0093 

4124 10908 NOP 

4126 07С1 MOVB R1,X*R15 

4128 045В RT 


** This routine is а delay rout 


412A СЯ?В моу XR11*,RI1 

412C 190909 NOP 

412E 0601 DEC Ri 

4138 16FD JNE %-›04 »412C 
4152 S45B RT 

ЖЖ Write Opcode Routine %% 

4134 С064 MOV G»FF6C(R4),R1 

4136 РЕС 

4138 Oó6AGg BL Q»4126 

413A 4120 

413C D1E4  MOUB G»5FFé6F(R4).R7 

413E ЕЕФЕ 

4140 8987 SRL к?, 8 

4142 #287 СТ Е?, >ва:1< 

4144 861525 

** Get data from РАВ for write 

4146 D1AF  MOVB Q»5FBFE(R15)0,Ró 

4148 FBFE 

414^ d6Có  SWPB Ró 

414C Di1AF MOVB Q»5FBFE(R15),Ró 

414E FBFE 

4150 91А0 CB Q»4852,Ró 

4152 4952 

4154 168E JNE %-›Е2 24972 
4156 95С65 SWPB RG 

4158 0906 MOVB R6,G»5FF7E(R4) 

415A FF7E 

415C D92F MOVB G»FBFE(R15),Q»FF82(R4) 
415E FBFE 

4160 ЕЕВ2 

4162 D92F MOVB @>FBFE(R15S) ,@>FFS1 (R4) 
4164 ЕВЕЕ 

4166 РЕЗ! 

4168 ОАЕ MOVB QG»5FBFE(R15),R6 

416A FBFE 

416C 1888 МОР 

416E D92F MOVB @>OFBFE(RIS) „2 ЕЕВО (R4) 
4178 FBFE 

4172 ЕЕВа 


ine. 


ж 


жж 
жж 
жж 
жж 


жж 
жж 
жж 


The data statement passed 
XX number of times to execute the delay 


Subtract the device name length 
Subtract 18 (Point to start 
of PAB) 

Add data statement to К! 
Move LSBvte of R1 into VDPWA 


Wait 
Move MSByte of К! 
Go back 


into VDPWA 


is the 


loop. 
XX Get number of times to loop 
жж Wait 
жж Done yet? 
Xx Мо?, loop again. 
жж Go back 
жж Data Buffer Address Pointer 
жж into R1 
жж Enter in middle of sub to set 
xx VDPWA to the data buffer in VDP 
xx Move Chr count to MSbyte R? 
** Put it іп LSbyte R7 
** Compare to See if 19 bytes 
Жж Where's the Jump if Greater? 
Жж Get day of week 

* Switch em 

** Read another 

** Check to see if it's a ’,’ 
Xx No? Then return an error 

** Put day back in High Byte 

жж Put it in DSR area 2855Е 
XX Get first digit of month 

** Get second digit 
ЖЖ Get rid of slash 
**X wait 
** Get first digit of day 








моув 


моув 


МОР 
MOVB 


MOVB 


SRL 
MPY 


MOVB 


моув 


SOCB 


MOUB 


MOVB 


NOP 


MOVB 


моув 


MOVB 


NOP 


моув 


MOVB 


G»FBFE(R1S),G»5FF7F (R4) 


@>ЕВРЕ (К15). Ко 


е» ЕВЕЕ (К15) .RS6 
Ко, е) ЕЕВ4 (RSG) 


ко, 8 
@>4856,R6 


@>FBFE(R15),R5 

RS, @FFE3(R4) 

R5,8 

к5.в7 

Ré 

@>4858,R6 

R?,R7 

%%>08 »41AA 
ез404в,е>ЕЕВЕ (RA) 
@>FBFE(R15),R6 


92:4052,К6 


$+ >86 
е› 4272 


»41B8 


QG»FBFE(R150,Q»5FF2D(R4) 


Q»404A,Q»5FF7D(R4) 


Q»FBFE(R15),QG»5FF?C(R4) 


@>FBFE(R15),R6 


@>FBFE(RIS) ,@>РРЕ?В (КЗ) 


@>ЕВРЕ (К15), @>ЕРР7А (ЮЗ) 


@>ЕВРЕ (К15),К6 


е> ЕВЕЕ (К15) .@>РЕ?9 (R4) 


е) ЕВЕЕ (15) „2 > ЕЕ? В (ка) 


++ 


* 


** 


** 


Get second digit of dav 


Get rid of slash 


wait 
Get first digit of year 


Move it into DSR area 
Move it into 16 bits 
Multiply Бу 10 


Get second digit of year 


Put it in DSR area 
Put 
Add it 
Set up 


Divide 


it in 16 bits 
to First digit # 19 
for divide 


by 4 
Check to see if a leap year 
If its not then jump 


Set bit 5 of first digit of 
byte 


Get the comma 
Is 


it а comma? 


Yes?, Keep going 
Report the error 


Get first digit of hour 


Set most significant bit of 
low nybble 

Get second digit of hour 
Get rid of colon 

Wait 

Get first digit of minutes 


Get second digit of minutes 
Get rid of colon 
Wait 


Get first digit of seconds 


Get second digit of seconds 


day 


the 
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41EC 
41ЕЕ 
а 1 та 
41F2 
41Ғ4 
41Е6 
41F8 
41FA 
41FC 
41FE 
42990 
4282 
4204 
4206 
4288 
428A 
429C 
429E 
4218 
4212 
4214 
4216 
4218 
421А 
421C 
421E 
4228 
4222 
4224 
4226 
4228 
422А 
422C 
422Е 
4232 
4232 
4254 
4236 
4258 


FF7a 
2296 
овар 
C144 
8225 
FF84 
8288 
5048 
620 
здар 
@&А@ 
412А 
0012 
DDS 
92435 
grao 
C1Có 
28697 
8487 
FLES 
494D 
D487 
0885 
509g 
8247 
ЗЕ@@ 
0287 
Е1Е@ 
ада 
0687 
51ЕЗ 
494Е 
0687 
9685 
2626 
16E9 
06896 
9469 
дава 


моу 


Ке, >S9SD 


RA,RS 
R5,»FF84 


R8, › 5846 
4840. жкв 
254 12А 


29519 
*RS,R3 
R3, SFIS 


Ró, R? 

R? 

R7.8 
с4840.к7 


в7,хез. 
вз,@›5йаё 


К7, 24е 88 


R7,X*R8 
Q»404E.R7 


R2,X*R8 
Q»4d4E.R7 


R7.XR8 
RS 

Ré 
$-»2C 
Ró, *R8 
ө»авв2 


>42096 


ХХ Read Opcode Routine ** 


423A 
423C 
423E 
4249 
4242 
4244 
4246 
4248 
424A 
424C 
424Е 
4258 
4252 
4254 
4256 
4258 
425А 
425C 


92026 
BSSD 
С144 
9225 
FF84 
D928 
4849 
FFéF 
9298 
5дад 
0629 
адар 
96А0 
412А 
68109 
028 
4851 
С1С6 


LI 


MOV 
АТ 


моув 


LI 


MOVB 


BL 


DATA 
MOVB 


MOV 


R6,»999D 


R4,R5 
RS, >FF84 


2540049.) ЕЕФЕ (К4) 


RS.»5949 
@>484D, ¥RB 
@>412A 


20215 
@>4951,*RB 


R6,R7 


++ 


** 
** 
жж 
жж 


жж 


жж 


жж 
жж 
жж 
жж 
жж 
жж 
жж 


жж 
++ 


жж 
жж 
жж 
жж 


ж 
++ 


жж 
жж 
жж 
жж 
жж 
жж 


жж 


же 


жж 


13 Bytes to vrite 


in RS 
in DSR area 


Duplicate GPLUS 
Point to 28364 
we want to put in clock) 
Point to enable bvte 


(bytes 


Enable the device 


Delay 218 times 


Move the byte into R3 

Mask out bits except for Low 
nybble of MSByte 

Сору Кб into R7 

Subtract one from К? 

Put it in MSByte 

Set Bits Ø and і of MSByte 


Move to enable byte 
Move to data byte 


Mask out bits 8,2 and 3 of MSBvte 
and all of LSByte 

Move it to enable byte 

Set bit 3 of MSByte 


Move it to enable byte 

Clear all but bit 3 of MSByte 
Move it to enable byte 

Subtract one from pointer to data 
Done yet? 

Nope?, Do it again 

Disable write byte 

Go back! 


We're going to read 13 bytes 


Put GPLWSP in RS 
Point to 28364 in DSR area 


Put 19 into chr count of DSR ar 


Enable Byte address in КӨ 


Put >C into Enable byte 


Delay 219 times 


Let it know we're going to read? 


Сору Ré into R2 


MOVB 


MOVB 


MOVB 


моув 


АМОТ 


MOVB 


моув 


моув 


моув 


MOVB 


MOVB 


MOVB 


DSR ARCHITECTURE 


R7 
R7,8 
@>4851.R7 


R2,XR8 


@>5888,R3 

@>4S4C,R3 

R3,XRS 

RS 

RS { 
$->1Е »425C 
Ró, ¥RB 

@>FF6C(R4),R1 

G»411E 


24905 
Q»FF7E(R4),R6 


Ко, @>ЕЕРЕ (Р15) 


Q»4052,Q»FFFE(R15) 
@>FFB2(R4) ,@>FFFE(RIS) 
GQ»FF81(R4),G»5FFFE((R15) 
@>9953, 2) ЕЕЕЕ (К15) 


е ЕЕВФ (К4), К6 
Ró, >33909 
Ко, @OFFFE (R15) 


В) РЕ?Е (К4), @>FFFE (RIS) 
@>4853,@>FFFE(RIS) 
ОЎҒЕВ4 (R4) , @>FFFE(RIS) 
е» ЕЕВЗ (К4), @>РЕРЕ (К15) 
е54852, 2 ЕЕЕЕ (К 15) 


е) ЕЕ? (н4) ,Ré 


жх 
жж 
++ 


++ 
++ 


** 
++ 
++ 
xXx 
++ 
жж 
++ 
x 


++ 


++ 
++ 


** 


** 


** 


+ 


жж 


жж 


++ 


** 


** 


** 


жж 


** 


++ 


жж 


** 


| + | 7 


Subtract 1 
Put it in MSByte 
Set 3 MSBits 


Tell it we want another byte 
Wait 


Get numeric value from data byte 


Add ascii offset for numbers 
Move it into DSR area 

Dec DSR area address pointer 
Done yet? 

Nope?, do it again 

Put Ө into enable byte 
Address to Pab Data buffer in 
Set up VDPWA 


Gonna write 
Get Day of week from DSR area 


Put it in Pab Data buffer 


Put a ',' in there! 


Move number of month in there 


Second digit of month 


Put in a '/' 


Get the day number 


Mask out anything greater than 


ASCII 3 


Put in PAB 


Put in the second digit 


Put in another ’/’ 


Put in the year 


Second digit of year 


, , 


Time for another А 


Get top digit of hour 


R1 





моув 


моув 


моув 


MOVB 


MOVB 


MOVB 


LWPI 


вв6,>5300 


Ев, Ф>ЕЕЕЕ (15) 


е) БЕТС (К4) „2? ЕРЕЕ (615) 


8548954 .0)ЕЕЕЕ (15) 


е) РЕ?В (К4) ,@>FFFE(RIS) 


е> РЕРА (В4), > ЕЕЕЕ (В 15) 


8654854 „е ЕЕЕЕ (Е 15) 


е) ЕЕ?9 (КЗ), @>РЕРЕ (Е 15) 


е) ЕЕ7?В (Ра), @>РРЕРЕЕ (15) 


Q»aogao 
285685 


е>азос 


жж 
жж 


жж 


** 


++ 


жж 


жж 


жж 


жж 


жж 


жж 
жж 


Mask out anything greater than 
ASCII 3 

Put it in PAB 

Put in second digit of hour 
Put in a 


Put in Minutes 


Put in second digit of minutes 


.. 
“ 


another ” 


Put in seconds 


Put in second digit of seconds 


Go back 


Load GPLUSP Test routine 
perhaps? 
Keep looping??? 
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2.4 Subroutine links 


Subroutine links (also known as low level routines or BASIC CALL 
subprograms) are the least documented program types available on DSRs. 
However, they offer the possibility of adding powerful new features to 
BASIC and XBASIC оп the /4A system. Subroutine links пау be of two 
types: low level routines or BASIC subprograms. Low level routines 
may be accessed via DSRLNK with a DATA >A (instead of 28) statement, 
as shown in the example code. Low level routines are not accessed by 
the FMS in the console, as are the main device routines. BASIC 
subprograms (ie- CALL FILES(x)), are accessed from the command mode of 
BASIC or XBASIC, and from running BASIC programs. The search DSR 
routine for subprograms іп XBASIC searches only GROMs апа not 
peripheral ROMs when the XBASIC program is running. ^ Both of these 
routine types can be included in peripheral DSRs to enhance or add 
features not available in other applications. Ап example of this is 
the Disk Drive Controller which has seven low level routines for 
disk/file access and adds "CALL FILES(x)" to the BASIC environment. 
Each of the two routine types is discussed further below. 


2.4.1 Low level routines 


Low level routines are accessed only by DSRLNK. The PAB values 
to be set are name length (1 byte) and the routine number (>10->FF). 
The low level routine may use registers RO - R10. Registers R11 - R15 
have the previously defined meanings. Upon entry into a low level 
routine, R11 should be saved. Data ог parameters may be passed 
through the FAC RAM area or at a known offset in the VDP from the PAB. 
The low level routine must include an error reporting subroutine that 
places the 3 bit error codes used by main device routines in byte 
28350. Table 1.2 lists the memory locations and contents. 


TABLE 1.2: LOW LEVEL ROUTINE PARAMETER ADDRESSES 


Address Contents 

2834А (FAC) data 1/0, parameter passing 

834B " 

834С п 

834р ү 

834Е Ы 

834Е н 

8350 MSB contains error codes upon return 
8352 data 1/0 


It is the responsibility of the application program to prepare 
data for transfer in the available addresses, prepare for the  DSRLNK, 
and read the error codes and any other data in the >834A->8352 
addresses returned by the DSR. Example I.4a lists partial code for a 
low level routine. Example I.4b lists partial code for accessing a 





SECTION l: DSR ARCHITECTURE . PG 120 


low level routine. Low level routines can be used in conjunction with 
an application program to add utility or special purpose functions 
that: 1) require speed (in assembly instead of BASIC), and 2) are 
versatile enough for use in more than one program, thereby justifying 
inclusion in ROM. 
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EXAMPLE I.4a: LOW LEVEL ROUTINE 


LLR10 


LLR20 


LLR10E 
LLR20E 
ERROR 


ERRTN 
RETURN 


AORG 
BYTE 
BYTE 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
BYTE 
BYTE 


1 I 


24000 
УДА 

1 
20000 


20000 


LLR10 


20000 


LLR20 
LLR1OE 
1 

210 


20000 
LLR20E 
1 

220 





link to 15% low level routine 


link to 2nd low level routine 

entry point of 1st low level routine 
name length 

low level routine number 


no more low levels 
entry point for 2nd low level routine 


low level routine number 


entry point of Тои level 210 


entry point of low level 220 


[set 3 MSbits of »8350] 
B *R11 


INCT 


R11 


B *R11 


return 


SECTION 
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РАВ 
DATBUF 
PABPTR 


ACCESS 


RETURN 


EXAMPLE I.4b: LOW LEVEL ROUTINE ACCESS 


DEF ACCESS 
REF DSRLNK , VMBW 
DATA 20110 
EQU 21000 
EQU 20Е80 


LI КО, >XXXX 
MOV RO, @>834A 


LI RO,PABPTR 
LI R1,PAB 

LI 5202 

ВИР @VMBW 
MOV RO, @>8356 
ВИР @>DSRLNK 
DATA >A 


name length 1, routine 210 
pointer to data buffer in VDP RAM 
pointer to PAB in VDP RAM 


load data for transfer 

put in ist address 

(load other data in FAC if needed) 
put PAB in >OF80 of VDP 


2 bytes to write to VDP 
write PAB to VDP 

put pointer to PAB іп 28356 
access to low level 


[check >8350 for error bits] 
[recover data in FAC] 


В *R11 
END 


return 
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2.4.2 BASIC CALL subprograms 


BASIC CALL subprograms are accessed from BASIC or XBASIC, and not 
through the FMS. Because of this, special care must be taken in 
interaction between the 'assembly' environment of the DSR апа the 
'GPL' environment of BASIC. The header for CALL subprograms is 
similar to that of low level routines. Errors may be returned by 
setting the BASIC token value at >8342 to >07. This will return an 
"INCORRECT STATEMENT" error in the BASIC program. DATA may be 
transferred from the BASIC environment by this program type (for 
example, CALL FILES(1)). The subprogram must manipulate the BASIC 
token pointer (>832C) and the current token (28342) to retrieve data 
and reset the current BASIC line token before returning to GPL. Other 
error bytes must be checked and cleared prior to returning also. The 
routine is responsible for keeping track of the current token pointer 
position, and adjusting it as needed. 

CALL subprogram routines may use the registers as defined for the 
low level routines. Errors can be returned as INCORRECT STATEMENT. 
The routine should not utilize GROM access, as this may disrupt GROM 
address settings assumed by the BASIC calling program. If GROM access 
is required, then the GROM address should be saved and then restored. 
As with all DSR accesses, it is the responsibility of the programmer 
to ensure that the routine does not disrrupt the BASIC/XBASIC 
environment while executing, or upon its return. Figure I.3 is a 
flowchart of а CALL subprogram. Example 1.5 demonstrates how а 
routine may be coded. The disassembled and commented CALL FILES of 
the Disk Drive Controller (from "Technical Drive") is also included. 
More documentation on these routines is available in the source code 
and technical manual for the Horizon RAMdisk. The source code file 
for the original version of the RAMdisk ROS section of CALL subs 15 
also included, and demonstrates how to recover input parameters from 
the BASIC environment, and handle errors. 
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ЕС. 1.3: CALL SUBROUTINE 


save return address 
save token pointer 
adjust token pointer 
to skip to end of line 





CALL sub routine ERROR 
put 207 in 2834г 


clear 28342 to end of 
line value (2002) 


recover return address 
send token value back 
то VDP 

reset token pointer 
clear floating pt. byte 
R11 = RI + 2 

return via R11 
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EXAMPLE 1.5: CALL SUBPROGRAM 


AORG »4000 
BYTE ЗАА 
BYTE 1 
DATA 20000 
DATA ---- 
DATA »0000 
DATA ---- 
DATA CALL1 link to 1st CALL sub 
DATA ---- 
DATA 20000 
САЩ 1 DATA CALL2 link to 2nd CALL sub 
DATA CALL1E entry point to 1st CALL sub 
BYTE 3 name length 
TEXT 'FPT' name of routine 
EVEN 
CALL2 DATA >0000 no more CALL subs 
DATA CALL2E entry point of 2nd CALL sub 
BYTE 5 name length 
TEXT 'MACRO' name of routine 
EVEN 
CALL1E $ entry point of 1st CALL sub 
MOV R11,R7 save return address 
MOV @>832C,R8 put token pointer in R8 
AI R8,3 add name length to get to end of line 
[routine for FPT] 
B GERROR only if error 
B GOKRTN return with no error 
CALL2E $ entry point of 2nd CALL sub 
MOV R11,R7 save return address 
MOV @>832C,R8 put token pointer in R8 
AI R8,5 add name length to get to end of line 
[routine for MACRO] 
B @ERROR only if error 
B GOKRTN return with no error 
ERROR LI ВО, ›0700 incorrect statement token 
MOVB RO,@>8342 put it in current token address 


JMP EXIT 
OKRTN SZCB @>8342,@>8342 makes end of line (200) current token 
EXIT MOV R7,R11 recover return address 
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MOV R8,R1 set token pointer 

SWPB R1 LSB first 

MOVB R1,@>8C02 move to VDP write 

SWPB R1 

MOVB R1,@>8C02 MSB next 

MOV R1,@>832C reset token pointer 

INCT R11 no other errors 

SZCB >4000,@>8354 clear floating point error 
B *R11 return 


END 


SECTION |: DSR ARCHITECTURE 


*BASIC CALL FILES ROUTINE FOR THE TI DISK DRIVE CONTROLLER* 


AORG >5D5A 


MOV R11,R7 

BL | 854724 

MOV @>002C(R9) ,R8 
AI R8, >0007 

BL 4824876 

CI RO,>C801 


JNE AA 
INCT R8 
BL | 054876 
SWPB RO 


AI ЮК0,24900 
CI К0,20009 
JH >5DAA 
SWPB RO 


MOVB RO,@>004C(R9) 

BL 0824658 

ОАТА 25084 

MOVB @>0050(R9) ,@>0050(R9) 
JNE »5DAA 

MOV @>002C(R9),R8 

AI Р8,2000С 

MOV R8,@>002C(R9) 

SZCB @>0042(R9) ,@>0042(R9) 


B @>4676 


*save return address 

*Init routine 

*token code pointer in R8 

*add 7 to skip 'FILES(' 

*get 2 bytes afer it 

*check for unquoted string, 
*length of 1 (tokenized code) 
*no?, then jump 

*point to ASCII / 

*get it from VDP 

*put ASCII # in Том byte, 

*»B6 in high byte 

*mask out ASCII offset 

*check if non-numeric 

*yes? then jump 

*put # of FCB's to reserve 

*in MSByte 

*put it in >834C for 216 return 
*do routine 216 (reserve buffers) 


*error? 

*yes? then jump 

*put token pointer in R8 

*point to end of statement 

*put it in token pointer 

*put 200 at 28342 (current token) 
*(end of statement indicator) 
*return 


PG 127 


5D5A 
5D5C 
5060 
5064 
5068 
506С 


5070 
5072 
5074 
5078 


БОУА 
5D7E 
5082 
5084 


5086 
508А 
5D8E 
5090 
5096 
5098 
5096 
5DAO 
5DA4 


SDAA 
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kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkžkkkkkkk*kxk 


RAMDISK OPERATING SYSTEM 


COPYRIGHT 1985, HORIZON COMPUTER, LIMITED 


+ + + + 0 9*6 OF 
+ + + + X * x 


-- ALL RIGHTS RESERVED -- 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkěkkkkkkkkkkkkkkkkxk 


ж * 
* This code consists of all of the CALL sub-* 
* programs accessable from TI BASIC and * 


* Ext. BASIC command mode except for CALL DM* 


* The code resides in the second 2K block. * 
* * 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk*kx 
* 


AORG »5800 
МТРА EQU 2415Е 
МАХЅЕС EQU 24010 
5У1 EQU 2419А 
ТЕМ EQU 24100 
ОМЕ EQU 24000 
SVADR EQU >41AA 
FAC EQU >834A 
DRIVE EQU 2400Е 
FCB EQU 24108 
SAVADR EQU >41A8 
УКМА EQU 24290 
VDPRD EQU 28800 
FCBDIF Е00 24104 
NUMDRV EQU 24014 
* 


CHANGE DRIVE NUMBER 


ж жж ж 


DRCNG МОУ R11,@SVADR 


MOV @>832C,R1 GET TOKEN POINTER 

AI К1,4 POINT TO TOKEN FOR TRANSFER 
BL — GCLRD CALL ROUTINE DIGIT READ 

МОМ @FAC+2,@FAC+2 ERROR? 

ЈЕО DRNO1 

B @DRERR 


DRNO1 А @FAC+4,R1 
MOV @FAC,R2 


SECTION 


DRNO2 


DRNO3 


DRNO4 


DRNOS 


DRNO6 
DRERR 


CALLRT 
CALLER 


DROPEN 


DROP1 


JGT 
B 

CI 
JLT 
B 
MOVB 
INC 
SWPB 
MOVB 
CI 
JEQ 
B 
MOVB 
BL 
MOV 
JEQ 
B 
MOV 
SWPB 
BL 
MOV 
JEQ 
B 
MOV 
JMP 
LI 
MOVB 
JMP 
SZCB 
MOV 
SWPB 
MOVB 
SWPB 
MOVB 
MOV 
INCT 
SZCB 
В 
MOV 
MOV 
AI 
MOV 
DEC 


DRNO2 
GDRERR 
кг, 7 
DRNO3 
@DRERR 
@>8800 , RO 
R1 

RO 
@>8800, RO 
RO, 182 
DRNO4 
@DRERR 
@DRIVE+1,RO 
@DROPEN 
@FCB,@FCB 
DRNOS 
@DRERR 
R2,R0 

RO 
@DROPEN 
@FCB,@FCB 
DRN06 
@DRERR 
R2,@DRIVE 
CALLRT 
RO, >0700 
RO, @>8342 
CALLER 


@>8342 ,@>8342 


@SVADR,R11 
R1 


R1,*R15 
R1,@>832C 
R11 


@>4014,@>8354 


*R11 
R11,R9 
@>8370,R8 
R8,6 

R8, GFCB 
R8 

@VRWA 
@VDPRD , R4 
R4,8 
@FCB,R8 
R8,5 
@VRWA 
GVDPRD, R5 
R5,R0 
DROP3 


I: DSR ARCHITECTURE 


»0? 


<7? 


GET PARENTHESIS AND EOL BYTE 
R1 POINTS TO EOL BYTE 


RIGHT PAREN? ) 


RE-LOAD WRITE REGISTER 
RESET TOKEN POINTER 


RETURN 


MAX # OF OPEN FILES 


DRIVE # 
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MOVB @VDPRD,R3 
JEQ DROP3 
B *R9 
DROP3 A @ЕСВОТЕ ,@FCB 
DEC R4 
JNE  DROP1 
CLR @FCB 
B *R9 
* 


* SET MAXIMUM SECTOR SIZE 
* 


MAXSC МОУ R11,@SVADR 
MOV @>832C,R1 
АГ  R1,4 
BL — GCLRD 
MOV @FAC+2,@FAC+2 
JEQ МАХО1 
B GDRERR 
MAXO1 А @FAC+4,R1 
MOV @FAC,R2 
JGT МАХ02 
B @DRERR 
МАХОг CI К2,1441 
JLT МАХОЗ 
В GDRERR 
MAX03 MOVB 828800,К0 
INC R1 
SWPB RO 
MOVB @>8800,RO 
CI ЖО, 182 
ЈЕО МАХ04 
В GDRERR 
MAXO4 МОУ R2,@MAXSEC 
B GCALLRT 


* CALL EXECUTE ROUTINE 
* 


EXCUT MOV R11,@SVADR 
MOV @>832C,R1 
АІ  R1,4 
BL — GCLRD 
MOV @FAC+2,@FAC+2 
JEQ ЕХО 
B GDRERR 
EX01 А GFAC«4,R1 
MOV R1,@>8300 
MOV @FAC,R2 
BL  *R2 
LWPI >83E0 
MOV @>8300,R1 
SWPB R1 
MOVB R1,*R15 


1ST CHAR FILE NAME 


GET NUMBER 
ERROR? 


GET PARENTHESIS AND EOL BYTE 
R1 POINTS TO EOL BYTE 


RIGHT PAREN? ) 


PG 130 | 
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XO 


: 
* 
* 
* 
* 
ж 
* 
* 
* 
* 
* 
* 
* 


CLR 


NM1 


NM2 


NM2 


SWPB 
MOVB 
INC 
MOVB 
SWPB 
MOVB 
CI 
JEQ 
B 

2 В 


@›8800, RO 
RO 
@>8800 , RO 
RO, 182 
EX02 
GDRERR 
GCALLRT 





PC 





READ A NUMBER FROM THE CALLING PROGRAM 


R1 - POINTS TO THE STRING DESCRIPTOR TOKEN 
RO-R3 ARE USED 


FAC 


RETURNS THE INTEGER 


FAC+2 0 FOR NO ERROR, 1 FOR ERROR 
FAC+4 NUMBER OF TOKEN POINTER MOVES 
FAC+6 TEMP STORAGE OF R1 


VDPWA/R1 


D MOV 
CLR 
CLR 
CLR 
MOV 
SWPB 
MOVB 
SWPB 
MOVB 
CLR 
MOVB 
INC 
CI 
JEQ 


5 MOVB 


LEFT POINTING TO NEXT CHAR/TOKEN 


R1i1,@SV1 
@FAC 
@FAC+2 
@FAC+4 
R1,@FAC+6 


@>8800,R1 
@FAC+4 
R1,»C800 
NM1 
@NMERR 
@>8800,R1 
@FAC+4 
R1,8 
R1,R1 

NM2 
@NMERR 
R1,7 
NM25 
@NMERR 
@>8800,R2 
@FAC+4 
R2,8 
R2,>002D 
NM27 


CHECK TOKEN FOR UNQUOTED STRING 


IF NOT, RETURN AN ERROR 
CHECK NEXT BYTE FOR LENGTH OF STRING 


20? 


(7? 


CHECK FOR MINUS SIGN 
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CI  R1,6 ARE THERE <6 DIGITS? 
JLT №35 
B @NMERR 
NM27 MOV @TEN,@FAC+2 
JMP №35 
ММЗ MOV @>8800,R2 READ A DIGIT 
ІМС @FAC+4 
SRL R2,8 
NM35 AI  R2,-48 
BL | GNMCK A VALID DIGIT? 
MOV RO,RO 8050 IF 0-9 
JEQ №4 
B @NMERR 
NM4 MOV R2,R2 IS DIGIT 0? 
JEQ М6 IF 50, SKIP MPY 
CLR R3 
MOV R1,RO COUNTER FOR MPY 
NM5 DEC RO 
JEQ NM6 DONE? 
MPY @TEN,R2 


NM6 MOV R2,R3 
DEC R1 MORE DIGITS? 


C @FAC+2,@TEN NEGATIVE NUMBER? 
JNE NM7 
NEG @FAC 
NM7 CLR @FAC+2 
B @NMRTN 


* 


* RETURN TO INTERNAL CALLER 
* 


NMERR MOV @ОМЕ,@ЕАС+2 
NMRTN MOV @SV1,R11 
MOV @FAC+6,R1 
B *R11 


* 


* CHECK DIGIT 
* 


NMCK LI RO,1 
MOV R2,R2 
JLT ММВ 
CI  R2,9 
JGT NMR 
CLR RO 
NMR B *R11 
* 


* PROTECTION ON 
* 


МЕРОМ МОУ R11,@SVADR 
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MOV @ONE,@WTPR 
MOV @>832C,R1 
AI R1,2 

JMP  WPNO1 


* 


* PROTECTION OFF 
* 


WRPOFF MOV R11,@SVADR 
CLR GWTPR 
MOV @>832C,R1 
АГ  R1,2 

WPNO1 В GCALLRT 

* 


* CARD CRU ON/OFF 
* 


CON INCT R11 
MOV R11,@SVADR 
MOV @>832C,R1 
AI R1,2 
JMP WPNO1 

COFF МОУ R11,@SVADR 
MOV @>832C,R1 
AP  R1,2 
JMP  WPNO1 


* 


* SET NUMBER OF DRIVES 1-4 
* 


SETNDR MOV R11,@SVADR 
MOV @>832C,R1 
АІ  R1,4 
BL еско 
MOV @FAC+2,@FAC+2 
ЈЕО STDRN1 
B @DRERR 
STDRN1 А @FAC+4 ,R1 
MOV @FAC,R2 
JGT STDRN2 >0? 
B @DRERR 
STDRN2 CI R2,5 «5? 
JLT STDRN3 
B @DRERR 
STDRN3 MOVB 8»8800,R0 
ІМС R1 
SWPB RO 
MOVB 828800,К0 
СІ 80,182 RIGHT PAREN? ) 
JEQ STDRNA 
B @DRERR 
STDRN4 MOV R2,@NUMDRV 
B @CALLRT 
END 
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SECTION J: DSR ACCESS 


1.0 Introduction 


The purpose of this section is to demonstrate how the console can 
access DSRS. Subsection 2.0 outlines how the console accesses 
interrupts, power up (initialization) routines, BASIC subroutine links 
(CALL xxx), and access of main device routines as files. Subsection 
3.0 provides a simple DSRLNK routine in assembly for use with  XBASIC 
(which does not load the DSRLNK routine as does the E/A cartridge). 
This is also provided as an example of DSR access programming for 
application programs. 


2.0 Console DSR Access 
2.1 Interrupt access routine 


The interrupt access routine is discussed first because it is a 
Stand-alone 9900 assembly routine located in the console ROM; other 
DSR access routines in the console are also in ROM or in GPL in GROMS 
0-2. The interrupt access routine flowchart is shown in Fig. 2.1. 
The disassembled and commented source code is given in Fig. 2.2. 
Commonly used address EQUates are given in Table 9.1. 

Upon entering the routine due to the detection of a low signal on 
the -INTREQ line, all interrupts are disabled to prevent further 
activation until the current interrupt is serviced. Тһе GPL workspace 
is loaded, and the CRU register (R12) is cleared. Тһе cassette and 
VDP interrupts are checked first. Then R12 is initialized and all 
peripherals from 21000 to 21Ғ00 are checked. If no peripheral caused 
the interrupt, the CPU returns to the main program. When searching 
the DSR, the routine checks for the header "АА" at byte 24000, then 
checks for the first interrupt routine. If there is an interrupt 
routine, the CPU will first save the next interrupt routine address in 
RO, and execute the current interrupt routine. Upon return from the 
first interrupt routine, the CPU will continue to execute subsequent 
interrupt routines until none are found for that peripheral. 
Therefore, апу peripheral may have an interrupt routine (if needed), 
and each peripheral may have multiple interrupt routines. It 15 the 
responsiblity of the individual peripheral to determine if it has 
caused an interrupt, and reset it when the routine is complete. All 
DSR interrupt routines are accessed whether or not they caused the 
interrupt, even after the one that caused the interrupt is found. 


2.2 GPLDSR access routine 


Access by the console to other DSRs is via routines in GPL in the 
console GROMs or assembly in the console ROMs. Each of these access 
routines (power up (ROM), CALL subprogram and main device/files 
(GROM)) use a routine referred to as GPLDSR. The GPL interpreter 
accesses this assembly language subroutine via an XML>19 command. Тһе 
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FIG. Ме 1: INTERRUPT ACCESS ROUTINE 


INTIALIZATION: 
disable interrupts, load GPL 


workspace, clear Ri2 (CRUD 


y 
is it а cassette interrupt? B @>1404 
y 
is it a VDP interrupt? JNE @>094A 





initialize R18 to 20Е00 
Ccounter value for search) 


clear CRU bit 0 




















odd 20100 to R12 counter 
“compare R12 to 22000; end? а В @>0AB8 


End routine: >0AB8 ->0АВЕ 
Cleor R8 (search pointer) 
load WP to INTWS 

RTWP - end of interrupt 










turn on CRU bit 0 


compare byte >400C to “АА”; 
is it the same? 


move byte >400C to AA 
(next int. routine in DSR) 


is it non-existent? 


save next int. routine 
address in RO 


get int. routine address 
in_RO 


INT. ROUTINE IN DSR 








recover nex int. routine 


from RO 
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FIGURE J.2.2: INTERRUPT ACCESS ROUTINE CODE 


AORG >0900 
LIMI >0000 *disable interrupts 
LWPI >83E0 *load GPLWS 
CLR R12 *clear CRU register 
* 
сос #20032,К14 “іс it the cassette int.? 
JNE МОСА5 *no, jump 
B 821404 *jump to cassette routine 
* 
NOCAS TB 202 *is it the VDP int.? 
JNE АВ *yes, jump to routine 
* 
LI  R12,»0F00 *load initial search value 
SBO 200 *turn on card 
* 
LOOP  SBZ 200 *turn off card 
AI R12,>0100 *add >0100 to search reg. 
* 
CI R12,>2000 *are we at the end? 
Е JEQ END *yes, jump to end 
SBO 200 *turn card on 
* 
CB @›4000,@›0000 *check for valid "AA" header 
JNE LOOP *no, start over 
ж 
MOV @>400C,R2 *save entry addr. in R2 


* 


NXTDSR JEQ 
* 


* 


END B 
END 


LOOP *no address, start over 
R2,R0 *save next addr. in RO 

@>0002(R2),R2 *get addr. for routine 
*R2 *branch and link to ISR 
*RO,R2 *recover next ISR addr. 
NXTDSR *check and execute 

е > ОАВВ *end, return 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


AORG >0AB8 
CLR R8 *clear ROM search pointer 
LWPI »83CO0 *load WP to INTWS 


RTWP 


*return 


PG J3 


0900 
0900 
0904 
0908 
090A 
090E 
0910 
0914 
0916 
091C 


091E 
0920 


0924 
0928 


092A 


092C 
0932 


0934 
0938 


093A 
093C 


0940 


0942 
0944 


0946 


OAB8 
ОАВА 
ОАВЕ 
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GPLDSR routine starts at 20АС0 and runs to 20820 in the console ROM. 
Although similar to the interrupt access routine, it is used only from 
the GPL environment. Тһе purpose of GPLDSR is to search all 0585, 
find and execute the requested routine type as needed. Since the 
remaining DSR access routines utilize GPLDSR, it is outlined first. 

Figure 2.3 is the flowchart for GPLDSR. Initially, R1 is cleared 
and is used as a DSR version counter. R2 is used as storage for the 
address table value. ›8300 is a predefined ROM/GROM address which may 
be set by the calling routine if the peripheral location is already 
known. 28302 15 used to save the program address while 28360 has ап 
increment, or table jump value set by the calling program to instruct 
GPLDSR which address table value in the DSR to branch to. 

Upon entry into GPLDSR, R1 is cleared and CRULST is checked. If 
a non-zero value is given in CRULST (ie, the peripheral CRU value is 
known, апа does not have to be searched for), then the routine 
branches to that peripheral CRU value directly. If CRULST is zero, 
then the GPLDSR routine steps through each peripheral (21000 - 21Е00), 
and checks for "AA" on the first byte. It then gets the first table 
entry value, and checks to see if it is non-zero. ІҒ non-zero, the 
address is saved in 28302. Тһе program entry point is stored іп R9. 
The name of the routine being searched for is checked by the routine 
NAMEMATCH (Section 2.2.1). If there is no match, the search routine 
continues. If there is a match, R1 is incremented, and the routine is 
executed by a BL *R9. When GPLDSR is complete, 1% branches to а 
subroutine (20842 which changes the value of CRULST before returning 
to the calling routine. If no matches are found іп any peripheral, 
GPLDSR branches to an error handler at 2006А. 


2.2.1 NAMEMATCH routine 


The NAMEMATCH routine is at >OBE8 - 20С08 in the console ROM, and 
is used by either ROMs or GROMs to match device names. CPU RAM 28354 
is SCLEN, апа the device name length; 2834А 15 МВА, the name buffer 
address (see Figures 2.5 and 2.6). 

Upon entry into NAMEMATCH, the device name length 15 retrieved 
from SCLEN and placed into R5 where it is used as a counter. ІҒ it is 
zero, then the CPU returns to the calling routine. Тһе value of R5 is 
compared to the value given by the address in R2; if not equal then a 
return is made directly via R11, indicating a problem. If the length 
is OK, then R5 is adjusted to the right byte, and R6 is loaded with 
the name buffer address (NBA). Next, NAMEMATCH checks to see if it is 
searching а GROM. If not, the counter value of R2 is incremented. 
The character (byte) pointed to by R6 is compared to that pointed to 
by R2. If not equal, a return with error is made. ТЕ the characters 
match, the loop continues until all characters are checked. If the 
device name length is correct and all characters match, then R11 is 
incremented by 2 (indicating no errors on return) and the CPU returns 
to the calling routine. 


2.3 Power up (initialization) access routine 


The power up access routine is in GPL іп GROM 0 at 20188 (Figure 
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FIG. J.2.3: GPLDSR ROUTINE 


Initialize: clear counter 
(R15 version of DSR 


non-zero, jump to SEARCH 


load R18 with initial value 
OK match, RISR1-*1 . 
be turned off 


execute routine DSR 
BL xR9 RBUTINE 


return fron DSR not there; 
jump to SEARCH 
NSTROM: next ROM (R12 + 


20100); clear CRULST іп case 
it is finished 





















LOOP: check and see if 
anything in CRU needs to 





ОК return turn off CRU 
jump to CHGRM 


finished search? CRU=>2000 





Clear ЖКВ 


CHGGRM: branch and link 





save address o 
turn on ROM 








next CRU; 


to routine to change 
ROM value 


END: return to GPL 









check first byte for 


go to first program pointer 
jump to ENDDSR 


SEARCH: continue where we 
left off; turn ROM back on 


ДА” 














ENDDSR: Is program pointer 
zero? if yes, then Finished). 
jump to LOOP 







save address м 28300; go 
to program entry point and 
get address 
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NXTROM 


* 


ж 


SEARCH 


* 


ENDDSR 


* 


AORG 
CLR 


MOV 
JNE 


LI 


MOV 
JEQ 


SBZ 


AI 
CLR 


el 
JEQ 


MOV 
SBO 
LI 


CB 
JNE 


AB 
JMP 


MOV 
SBO 


MOV 
JEQ 


MOV 
INCT 
MOV 
BL 
JMP 
INC 
BL 


JMP 








FIGURE 9.2.4: GPLDSR ROUTINE CODE 


»0ACO 
R1 


@>83D0,R12 
SEARCH 


R12, >0F00 


R12,R12 
NXTROM 


200 


К12,20100 
8528300 


R12,>2000 
END 


R12 ,@>83D0 
200 
#2, 24000 


*R2,8»000D 
LOOP 


@>836D ,@>83E5 
ENDDSR 


@>83D2 ,R2 
200 


*R2,R2 
LOOP 


R2,@>83D2 
R2 
*R2+,R9 
@>0BE8 
SEARCH 

R1 

*R9 


SEARCH 


*clear counter R1 


*get ROM search pointer (CRULST) 
*if none, jump to SEARCH 


*load initial value 


*check CRULST 
*if none, jump to NXTROM 


*turn off card in case done 


*add 20100 to CRULST 
*clear search pointer 


*at the end? 
*yes, jump to end 


*move R12 into CRULST 
*turn on card 
*set R2 to 24000 (ROM addr) 


*valid "AA" header? 
*no start over 


*calculate program entry addr. 
*jump to ENDDSR 


*move save addr. into R2 
*turn on card 


*no entry address given? 
*start over 


*move R2 into save addr. 
*add 2 to R2 

*point to name 

*check name via NAMEMATCH 


*error, no match return 


ЖОҚ return, increment version no. 


*execute routine 


*return if wrong peripheral 


PG J6 


ОАСО 
ОАСО 


ОАС2 
ОАС6 


ОАСВ 


ОАСС 
ОАСЕ 


OADO 


OAD2 
OAD6 


OADA 
OADE 


ОАЕО 
OAE4 
OAE6 


OAEA 
OAEE 


OAFO 
OAF6 


OAF8 
ОАЕС 


ОАЕЕ 
0800 


0B02 
0806 
0808 
ОВОА 
ОВОЕ 
0810 
0812 


0814 
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SBZ 
JMP 


* 


CHGGRM BL 
* 


END B 


R1» DSR version number 
R2- address table value 


»00 
CHGGRM 


*R8 
820842 


@>006А 


PO 7 





*correct peripheral return, turn 
off card 
*jump to CHGGRM 0B18 


*return for other routines ОВТА 
*change ROM search value routine OBIC 


*return to GPL 0B20 


28300- predefined ROM/GROM value 


28302- save address 


»836D- jump increment for DSR entry table 


>83E5= R2 LSB 
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FIG. 20.5: МАМЕМАТСН ROUTINE 
get name length, use as 
о counter (RS) 
y 


2 compare name length with 
value in Re; по match? return 
to END 















adjust R3 counter to right 
byte 


load R6 with Name Buffer 
Address 


COMPARE: are we searching 
a GROM? 


R2=R2+1 (GROMs don’t need 


to increment) 


is character correct? if not 
exit to END 






counter = counter - 1 


15 the counter > 0? return 
to COMPARE 


MATCH: finished, match ОК, 
return 


END: return, no match 
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* 


COMPAR 


* 


* 


CHKCHR 


* 


* 


ENDOK 
* 
ENDBAD 


AORG 


MOVB @>8355,R5 


JEQ 
CB 


20ВЕ8 


ЕМООК 
R5,*R2 
ENDBAD 


R5,8 
R6 , >834A 


R2 ,>9800 
CHKCHR 


R2 
*RO+, *R2 
ENDBAD 


R5 
COMPAR 


R11 


*R11 





FIGURE J.2.6: NAMEMATCH ROUTINE CODE 


*get name length, put in R5 for 


*END if zero 

*compare name length with value in 
R2 

*END if bad 


*adjust to right byte 
*put NBA in R6 


*searching a GROM? 
*yes, jump 


*no, this is ROM, increment addr by 
1 


*compare characters 
*no match, end bad 


*counterscounter-1 (R5) 
*keep going 


*good return 


*error return 


ОВЕВ 
ОВЕВ 
ОВЕС 
ОВЕЕ 
ОВЕО 


OBF2 
OBF4 


OBF8 
OBFC 


OBFE 
0600 
осбг 


0604 
0606 


0608 
ОСОА 
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2.7 and 2.8). This will cycle through all peripherals and execute any 
power up routines found. The power up access routine clears CRULST 
(28300) since a specific device or subprogram name 15 not being 
searched for, and SCLEN (58354) is also set to zero. A jump value of 
204 is stored at 28360 to tell GPLDSR where to start in the DSR access 
table. Then a branch to XML >19 (GPLDSR) is made. This access 
routine is made very early during the power up sequence and allow 
initialization of the peripherals before they are accessed by the 
console. 


2.4 CALL subprogram access routine 


When a CALL subprogram is executed from a running BASIC program, 
or in the command mode of BASIC or XBASIC (DSRs in peripheral ROMs are 
not searched by XBASIC programs during execution), then the GPL code 
at 25008 - 55110 is executed (see Fig. 2.9 and 2.10). First, 2830С 
is cleared, and the contents of 2832С are set equal to those of 58356. 
The CPU checks to see if the subprogram is in GROM or ROM. If in ROM, 
a CALL 6820010 is executed, and the GPL DSRLNK routine is accessed. A 
data value of 20А is used as a jump value for proper entry in the DSR 
address table. 

The GPL DSRLNK routine is at 2030С - 20415; the flowchart is 
shown in Fig. 2.9. Upon entry, the jump value is recovered and put 
into 28360. Тһе MSB of the SCLEN (58354) is cleared and the 
device/subprogram name length is placed in 28355. The name length 
variable for this routine (28358) is cleared. The word value іп 28356 
is moved to 28352, which is used as a counter. Тһе main loop compares 
the device name length іп 28355 to 28358 to see if it is equal; if so, 


an exit is made. Тһе character value is checked to see if it is a 
"."; if so, the loop is exited. Otherwise, the value of 28358 is 
incremented until it equals SCLEN or a "." is reached. This loop 


allows the device name to be shortened to characters left of a ".", 
thereby eliminating device options not needed in the search. Ап 
example of this would be "PIO.CR.LF" becomes "PIO.". The GPL  DSRLNK 
routine is also used by the Main Device search routine as noted in 
Subsection 2.5). Once the loop is exited, the name length is checked 
to see if it is zero; if so, an error is returned. The new device 
name length is now moved from 28358 into 28355. If it is greater than 
8 characters long, an error is returned. Now the MSB of SCLEN is 
cleared (again), the ROM search pointer CRULST (28300) is cleared, the 
subroutine pointer at 28356 is incremented by two, and the device name 
is moved to the buffer at >834A (NBA). Тһе word at 28356 is moved to 
28354 and now 28355 is the new device name length. Then GPLDSR is 
called via a XML »19. 


2.5 File/Main Device access routines 


BASIC and XBASIC can access peripherals through the console File 
Managment System which utilizes Peripheral Access Blocks or PABs. Тһе 
File Managment System and PABs are covered in Section K. Because of 
the design of the File Management System, all peripherals' main device 
routines are accessed as files via different commands (or modes) such 
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Е НЕО” РОТЕ 





clear GRDM/RDM search 
pointer 







clear device name length 









in »836D (offset)? 





store »04 









XML 219: search powerup 
DSRs in ROMs and execute 





GPL DSR 
ROUTINE 
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DCLR 
CLR 
SI 


XML 
END 


PG J12 





FIGURE J.2.8: POWERUP ROUTINE CODE 


@>83D0 
@>8355 
@>836D, >04 


219 


*clear ROM search pointer 0183 
*clear device name length byte 
*store 204 in counter 28360 


*go to GPLDSR 


0186 
0188 


0188 
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FIG. J.2.9: SUBPRUGRAM ACCESS ROUTINE 


Initialization: 
clear >830C, set >832C=>8356 


is the program in СКОМ? if 
no, jump to ROM 


GROM address setup 


ROM: go to GPL DSRLNK with 
data value of ЖА (subprogram > 
offset) 


RTNBAD: subroutine not found, 
еггог 


ПКРТМ: is 28342 zero? 


no, error, return to main 



















Note: 

»83eC-program text or token code pointer 
»8356-subroutine pointer 

»830C-temp. variable 
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FIGURE 9.2.10: CALL SUBPROGRAM ROUTINE CODE 


CLR @›830С *clear 2830С temp. variable 50E0 
DST 1(528356,82832С *set token code pointer = subroutine 50E2 
pointer 
* 
CZ 828389 *15 the subprogram іп GROM? 50E5 
BS 6825101 *no, in ROM, jump 50E8 
* 
MOVE 0001 BYTE TO 828300 FROM G@>0000(@>832C)  *GROM access 50EA 
INC 858300 *code 50F 1 
MOVE #2830С BYTE TO V@>0320 FROM G@>0000(@>832C)* 50F3 
DST @>8356,>0320 7 50FA 
DADD @>832C,@>830C * 50FE 
* 
ROM CALL G@>0010 *go to GPL DSRLNK 5101 
DATA >OA *with data value of >0A (entry offset 5104 
value) 
* 
BS G@>510C *error return 5105 
* 
CZ @>8342 *good return, check for end of line 5107 
BR G@>5671 *no, error 5109 
* 
CONT *continue 510B 


END 
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as OPEN, CLOSE, DELETE, etc. Тһе access routines are in GPL in GROM 
2; all 1/0 mode routines utilize the GPL code from >4CB9 - >4CE9 with 
three entry points: 24С89, 24СС0, апа 24СС6. Below is a list of 
a modes and their associated entry points (for console BASIC 
only): 


1/0 mode Entry point 


OPEN 24СС6 
DELETE 4CB9 DATA 207 
CLOSE 4CC6 
RESTORE 4CB9 DATA »04 
INPUT 4CCO 
LOAD 4CC6 
SAVE 4CB9 DATA >06 


[Note: The entire file access system logic is beyond the scope of 
this manual. Only the common access routines are provided. ] 


Figure 2.11 is the flowchart of the files access routines from 
24С89 - »4CE9. At entry point >4CB9, the opcode is recovered from the 
DATA statement following CALL G@>4CB9 and is written to the VDP. 
Entry point >4CCO does not assume use of the DATA statement, and 
directly calls the last routine at entry point »4CC6. Upon return 
from »4CC6, the subroutine may either branch to an error message, or a 
normal return. Entry point »4CC6 installs the screen offset value and 
saves the FAC. The pointer for the DSR value is recovered, and an 
offset of 200 is added to provide proper table entry into the 058. 
Then GPL DSRLNK is called with a data value of 208. Upon completion, 
the FAC is restored, checking is done for errors, and a proper return 
is made. 

A point of interest is the GPL code from 24ВА1 - >4BFB. This 
section apparently is used by the console in creating PABs. 


3.0 XBASIC DSRLNK 


The XBASIC cartridge from Texas Instruments does not load DSRLNK 
when а CALL INIT is issued, and therefore it is not available when in 
the XBASIC environment. The following assembly program (provided by 
TI) demonstrates how a DSRLNK assembly program maye access the RS232 
card, print a message, and return to the XBASIC calling program. The 
code and comments are provided to assist programmers in understanding 
how the console accesses DSRs; note that several routines are very 
similar to those presented in Subsection 2.0. 
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FIG. J.2.11: GPL DSRLNK ROUTINE 


get jump address value, put in »836D 


clear >8354 (name length MSB) 
get device name length, put in >8355 


clear 28358 (name length variable for 
this routine? 
put word іп @>8356 in 8928352 (pointer? 





LOOP: counter=countert+e ©8352) 


compare value of >8358 to name length 
if equal, jump to 60 












У/ compare character at position >8352 
to 4,4 (period). if equal jump to GO 


ise, increment 28358 and jump 


GO: is the name length zero? y 
if yes, then exi 
now replace old name length @>8355 
with new @>8358 
y 


check if length > 8 chorocters; i£ 
со, then exit 





clear @>8354 (MSB of name length) 


clear 628300 ‘ROM search pointer? 
increment subroutine pointer 
28356 value by г 

move device name to buffer at 
2834А (NBA) 

move word 628356 to 28354; 

now >8355=name length 


go to GPLDSR 
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LOOP 
* 


FETCH 828360 


CLR 
ST 

CLR 
DST 


DINC 


CEQ 
BS 


CEQ 
BS 


INC 
BR 


CZ 
BS 


ST 
CGE 
BS 
CLR 
DCLR 
DINC 
MOVE 
DADD 


XML 
END 


828354 
@>8355,V*>8356 
@>8358 
@>8352 ,@>8356 


@>8352 


@>8358 ,@>8355 
G@>O3FA 


үж;8352,22Е 
G@>03FA 


@>8358 
G@>03E9 


@>8358 
5820438 


@>8355, @>8358 
@>8355,>08 
5820438 
828354 


828300 
828356 


*»8354 BYTE TO @>834А FROM V*>8356 *move new name to VDP 


@>8356 ,@>8354 


219 


FIGURE 9.2.12: GPL DSRLNK ROUTINE CODE 


*get jump addr. value, put in 28360 
*clear name length MSB 


*get device name length, put in 28355 


*clear name length variable 
*put pointer value in 58352 


*counter=counter + 2 


*is name length equal? 
*yes, jump to GO 


*is the current character "."? 
*yes, jump to GO 


*otherwise, increment 28358 
*and start again at 100Р 


*is the name length zero? 
*yes, then exit 


*replace old name length with value 
in 28358 


*is it greater than or equal to 8? 
*yes, then error exit 


*clear MSB of name length word 
*clear ROM search pointer word 
*increment subroutine pointer by 2 


buffer 
*move word at 28356; now >8355=name 
length 


*go to GPLDSR routine 


0306 
03DE 
ОЗЕО 
03Е4 
03Е6 


03Е9 


03ЕВ 
ОЗЕЕ 


03Ғ0 
03Ғ4 


03Ғ6 
03Ғ8 


O3FA 
O3FC 


O3FE 
0401 
0404 
0406 
0408 
040B 
040D 


0412 


0415 
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FIG. лез MAIN DEVICE/FILES: ACCESS: ROUTINES 


ENTERI 









recover opcode from “CALL 
G@>4CB9 DATA Xx’ 


write opcode to VDP 


CALL G@>4CC6 (go to 
ENTER3) 
| 


install screen offset (2602 
Sove FAC 










ЕМТЕК2 


ЕМТЕКЗ 














get pointer for DSR from 
28304; add 201 for proper 
entry point 


coll GPL DSRLNK with а 
DATA »08 












restore FAC; branch to 
error routine if needed 





check for errors; Ю11=Ю11+е; 
normal return 


SECTION J: DSR ACCESS. PC J19] 


FIGURE J.2.14: MAIN DEVICE/FILES ROUTINE CODE 


ENT1 FETCH @>8356 

ST ү820004( 828304) ,@>8356 
ж 
ENT2 CALL G@>4CC6 

BR G@>57C3 

RTN 


ENT3 ST V@>000C(@>8304) , >60 
MOVE 2001Е BYTE TO \@>03С0 FROM @>834A 
DST @>8356,@>8304 
DADD @>8356,>000D 
CALL G@>0010 
DATA 208 
MOVE >OO1E BYTE TO @>834A FROM V@>03C0 
BS G@>4CE9 


CLOG V@>0005(@>8304),>E0 
RTNC 
END 


ck ХКК КК КК ke e e e ee e ke e kk КК 


build PAB is located at >4BA1 - 24ВЕВ 


*recover opcode from 4СВ9 
*calling routine (DATA 4CBB 
>ХХ) and write to VDP 
*call ENT3 routine 4CCO 
*error return 4CC3 
*normal return 4CC5 


*install screen offset 4СС6 
*save FAC 4CCB 
*get pointer from 28304 4CD1 
*add 200 for entry addr 4С04 


*call GPL DSRLNK 4CD8 

*with a DATA »08 4CDB 

*restore FAC ` 4CDC 

*branch to error if 4CE2 
needed 


*check for other error 4СЕ4 
*return + 2 no errors 4СЕ9 
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kc ec ce eee e ke e kk ec ke ke e ke e ke ck ck ke ЖЖ ЖК 


* 


* 


* 


* DSR ROUTINE FOR EXTENDED BASIC ENVIORNMENT * 
* 


kc e ee ke e ke e ke ke e e ehe e e e ee he e ke e ke ke he hk ke e e ko АС 


* 


SCLEN EQU 
SCNAME EQU 
CRULST EQU 
SADDR EQU 
GPLWS EQU 
VDPRD EQU 
VDPWD EQU 
VDPWA EQU 
FLGPTR DATA 
SVGPRT DATA 
SAVCRU DATA 
SAVENT DATA 
SAVLEN DATA 
SAVPAB DATA 
SAVVER DATA 
DLNKWS DATA 


TYPE DATA 
ж 

***DATA 

* 

C100 РАТА 
H20 Ға) 

H2000 DATA 
DECMAL TEXT 
НАА BYTE 


* 


28355 
28356 
28300 
58302 
283Е0 
28800 
28С00 
»8C02 
0 


0 
0 
0 
0 
0 
0 
0 
0 


100 


$ 
22000 


2АА 


***UTILITY BLWP VECTORS 
* 


DSRLNK DATA 
* 


DLNKWS , DLENTR 


***LINK TO DSR 


* 


DLENTR MOV 
SZCB 
MOV 
MOV 
Al 
BLWP 
MOVB 


LNK$LP INC 


*R14+,R5 
@H20,R15 
@SCNAME , RO 
RO,R9 
R9,-8 
@VSBR 
R1,R3 
R3,8 

R4 

R2 , NAMBUF 
RO 

R4, R3 
LNK$LN 


NAME LENGTH 

NAME BUFFER POINTER 
CRU ADDR VALUE 

SAVE ADDRESS BYTE 
GPL WORKSPACE 

VDP READ ADDR 


POINTER TO FLAG BYTE IN PAB 
SAVE GPL RETURN 

*CRU ADDRESS OF PERIPHERAL 
*ENTRY ADDRESS OF DSR 

SAVE DEVICE NAME LENGTH 
POINTER TO DEVICE NAME IN PAB 
*VERSION OF DSR 


LINK TO DSR 


FETCH PROGRAM TYPE FOR LINK 
RESET EQUAL BIT 

FETCH POINTER INTO PAB 

SAVE POINTER 

ADJUST POINTER TO FLAG BYTE 
READ DEVICE NAME LENGTH 

STORE IT 

MAKE IT A WORD 

INIT COUNTER 

ADDRESS OF BUFFER TO HOLD NAME 


END OF NAME? 
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LNK$LN 


* 


BLWP @VSBR 

MOVB R1,*R2+ 

CB А1, @DECMAL 
JNE LNK$LP 

MOV R4,R4 

JEQ LNKERR 

CI  R4,7 

Чат LNKERR 

CLR @CRULST 
MOV R4,@SCLEN-1 
MOV R4,@SAVLEN 
ІМС R4 

А R4 , @SCNAME 
MOV | GSCNAME , GSAVPAB 


***SEARCH ROM FOR DSR 
* 


SROM 


NOROM 


NOOFF 


***SEE 


* 


NAME 1 


LWPI GPLWS 

CLR R1 

LI К12,20Ғ00 
MOV R12,R12 
JEQ МООРЕ 

SBZ 0 

AI R12,>0100 
CLR @CRULST 
CI | R12,»2000 
ЈЕО №058 

MOV R12,@CRULST 
580 0 

LI К2,24000 
CB | *R2,G8HAA 
JNE NOROM 

A GTYPE,R2 
JMP 5602 

MOV @SADDR,R2 
SBO 0 

MOV *R2,R2 
ЈЕО МОКОМ 

MOV R2,@SADDR 
INCT ка 

MOV *R2+,R9 


IF NAME MATCHES 


MOVB @SCLEN,R5 
JEQ МАМЕ2 

CB.  R5,*R2* 
JNE 5600 

SRL R5,8 

LI | Re,NAMBUF 
CB  *R6+,*R2+ 
JNE 560 





READ A CHARACTER 
MOVE TO NAMBUF 
A PERIOD? 


IS NAME LENGTH ZERO? 
ERROR ROUTINE 
IS NAME LENGTH > 7? 
ERROR ROUTINE 


STORE NAME LENGTH FOR SEARCH 
SAVE LENGTH 

NEXT AVAILABLE POSITION 
POSITION AFTER NAME 

SAVE POINTER INTO DEVICE NAME 


USE GPLWS FOR SEARCH 


START 
ANYTHING TO TURN OFF? 


TURN OFF 

NEXT ROM 

CLEAR IN CASE WE'RE FINISHED 
END OF CONSOLE ROM 

DIDN'T FIND DSR 

NEXT CRU 

TURN ON ROM 

START AT BEGINNING 

IS IT A VALID ROM? 


GO TO FIRST POINTER 


CONTINUE WHERE WE LEFT OFF 
TURN ON AGAIN 

ZERO? 

NO PROGRAM 

REMEMBER WHERE TO GO NEXT 
60 TO ENTRY POINT 

GET ENTRY ADDRESS 


GET LENGHT AS COUNTER 
ZERO LENGTH, NO MATCH 
LENGTH MATCH? 


MAKE WORD 
POINT TO BUFFER 
CHARACTER CORRECT? 


SECTION J: DSR ACCESS Ре J22 








DEC R5 MORE TO LOOK AT? 
JNE МАМЕ1 
МАМЕ? ІМС М NEXT VERSION FOUND 
MOV R1,@SAVVER SAVE VERSION NUMBER * CAN BE USED * 
MOV 89, GSAVENT SAVE ENTRY POINT * TO AVOID * 
MOV  R12,GSAVCRU SAVE CRU ADDRESS * SUBSEQUENT * 
BL —*R9 CALL SUBROUTINE * SEARCHES * 
JMP 560 NOT RIGHT VERSION 
SBZ 0 TURN OFF КОМ 
LWPI DLNKWS SELECT DSRLNK WORKSPACE 
MOV R9,RO POINT TO FLAG BYTE IN PAB 
ВИР @VSBR READ FLAG BYTE 
SRL R1,13 SAVE ERROR FLAGS 
JNE IQERR ERROR? 
RTWP 
ж 
***ERROR HANDLING 
* 
NODSR LWPI DLNKWS DSRLNK WORKSPACE 
LNKERR CLR R1 CLEAR ERROR FLAGS 
IOERR SWPB R1 
MOVB R1,*R13 STORE ERROR IN RO OF CALLER 
SOCB 8H20,R15 INDICATE AN ERROR 


RTWP RETURN TO CALLER 
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TABLE 9.1: DSR-RELATED RAM ADDRESSES 


Address Name Description 
»202E FLGPTR pointer to the flag in the PAB 


22030 SVGPRT GPL return address 

»2032 SAVCRU CRU address of the peripheral 

»2034 SAVENT entry address of DSR or subprogram 

»2036 SAVLEN device or subprogram name length 

22038 SAVEPAB pointer to the device or subprogram name іп РАВ 
»203A SAVVER version number of the DSR 


28300 - >834F used by BASIC and XBASIC for temporary storage; 
the following address apply to DSRs and/or PABs 

»832C pointer to token code 

»833C pointer to first entry in PAB list 

28342 current character/token 

»834A - »836D FAC (floating point accumulator) 

>834A PAB I/0 code 

>834В flag/status 

»834C .data buffer address 

2834Е logical record length 

»834F character count 

28350 record number 

28352 screen offset 

28353 option length 


28354 SCLEN device length 
58356 SCNAME subroutine pointer/ 1st char after PAB in VDP 


28358 - 28360 DSR use 

2836Е - 28378 misc. GPL usage 

»837C STATUS GPL status byte, set to zero for DSR call. 
Bit 2 is cond. bit; console turns this bit 
on to indicate non-existant file. 

28380 - >83BF misc. GPL usage 

»83C0 - >83DE INTWS Interrupt workspace, also: 


28300 CRULST 
28302 SADDR 


283Е0 ->83FF GPLWS GPL workspace 
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LIO. 2.195: OVERALL ACCESS 


CONSOLE 


INTERRUPT 


POWER UP 


CALL 
SUBPRG 


MAIN DEV 
FILES 





ат, A ыз GPL 
DSRLNK 
FILES es] 
ACCESS 





>XML 19 
GPL DSR 





DSR 
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SECTION K: MISCELLANEOUS ACCESS NOTES 


1.0 Introduction 


As the title implies, this section covers some miscellaneous tips 
and techniques on accessing peripheral devices. Subsection 2.0 
briefly covers direct access of peripherals and their 058$. 
Subsection 3.0 summerizes information on Peripheral Access Blocks 
(PABS), particularly as they apply to interaction with DSRs. 


2.0 Direct Access 
2.1 Memory access 


Access to the DSR or peripheral (if memory mapped) by the 
console, or access to system memory by the DSR is straightforward. 
All possible memory locations fall between 24000 to »5FFF for 
peripherals; it is assumed that the proper CRU manipulations have been 
performed to page in the desired peripheral into the 24000 space prior 
to access. The CRU base address should not be changed by the DSR 
until the >4000 memory space is exited unless the contents of R12 are 
saved upon entry into the DSR.. 

Data may be moved between the peripheral/DSR and the system via 
MOV and MOVB instructions. MOV will transfer a 16 bit word, while 
MOVB transfers the MSB of a 16 bit word. Some examples of these 
instructions are as follows: 


Operation Example Description 
register to register MOV R4, RO move contents of R4 into RO 
MOVB R4, RO move R4 MSB to RO MSB 
register to memory MOV R4, 8240С0 move contents of R4 into 
address 240С0 and 240С1 
MOVB R4, @>40C0 move R4 MSB to byte 240С0 
register indirect MOV R4, *RO move contents of R4 to 
address given in RO 
MOVB R4, *RO move R4 MSB to MSB of 
address given in RO 
reg. auto-increment MOV R4, *R1+ move contents of R4 into R1 
and increment КТ by two 
MOVB RA, *R14 move R4 MSB into R1 MSB and 
increment R1 by one 
indexed memory MOV @>4033(R3), R2 move contents at address 


given in R3 plus 24033 
MOVB @>4033(R3), R2 move MSB between locations 


Other transfer modes are possible. The Indexed Memory and 
Auto-Increment are very common, particularily with memory mapped 
devices, and VDP transfers. It is recommended that the programmer use 
labels for commonly referenced addresses. Care must be taken with 
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devices such as GROMs, which autoinrement their addresses with each 
access. 


2.2 CRU access 


Individual CRU bits may be manipulated via the SBO and SBZ 
commands. For example, if register 12 contains the base CRU address, 
21500 for example, then 


SBO 0 
would activate СВУ bit 21500 to 1 or "on". Likewise, the command 
SBZ 4 


would set CRU bit 21508 to 0 or "off". 580 0 and SBZ 0 are found in 
the DSR access routines and are used to activate the peripheral device 
and its DSR ROM. Other 580/582 commands can be found in the 058 
itself that manipulate the indicator light or other functions. The 
programmer is reminded that all DSR software should clear any CRU bits 
activated when exiting the DSR (the FMS will deactivate the 0 bit). 
Most CRU bits toggle latches or flip flops which may remain active 
unless its CRU bit is cleared, causing bus contention once the DSR is 
exited. 

The command TB can be used to determine the status of a CRU bit. 
Following the previous example, if the СВУ base is 21500, then 


TB 25 


would input the value (1 or 0) of CRU bit >150A. TB works only for 
peripherals that have an active CRUIN line to the console. 

The multiple bit transfers are more involved than the single bit 
transfers. Register 12 contains the starting address of the CRU bit 
selected, and the count "n" in the instruction indicates the decimal 
number of successive bits to be transferred. Гог example: 


LDCR @>4351 ‚4 


The command LDCR is an output operation. 1% transfers data from 
the memory location 24351 (example) to the 4 CRU bits, starting at the 
address that is the value of the contents of register 12. If n, the 
number of bits to be transferred, is less than 8 the address is a byte 
address. If n is 8 or more, the address represents a word address. 
If n is 0, 16 bits are transferred. If using register addressing, the 
byte addressed (for n less than 8) is the left byte of the register 
containing the data. These statements apply equally to the input 
operation STCR, which inputs n bits from the CRU device and stores 
them in the specified memory location. For example, to input 6 bits 
to the memory location addressed by the contents of register 10 would 
require 


STCR *R10,6 
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Single bit operations are usually associated with standard DSR 
peripherals, while multiple bit CRU operations are useful for CRU-only 
peripherals, or ones with 9901 interface chips. 





2.3 Programming examples 


Some simple assembly programming examples for accessing various 
peripheral types are provided below. Note that all peripherals that 
do not use a DSR in ROM must be accessed directly by an applications 
program located in the system RAM, and cannot be accessed Бу the FMS 
of the /4A. 


*CRU-only 
LI R12,>0600 set CRU base for 20600 
SBO 4 turn on »0608 bit 
END SBZ 4 turn off 20608 bit 
B *R11 return 


*Non DSR peripheral 
These peripherals are paged into the 24000 space by an 
independent applications program, and not the console. 


LI К12,21500 set CRU base for 21500 
SBO 0 turn on bit O. could be any bit within assigned 
range of CRU bits 


([program/device access] 


END SBZ 0 turn off peripheral (bit 0) 
B *R11 return 


*DSR peripheral 

These peripherals are normally accessed by the console FMS. 
However, they can be accessed via an applications program using code 
similar to the previous example. 


*Non-CRU memory-mapped 

These devices are in the 24000 - 25ҒҒҒ memory address space, but 
are paged in only when no other DSR peripheral is active. Although 
this feature is implemented in hardware (see Section C), the following 
code may be used to ensure that conflict does not occur. 


LIMI 0 disable interrupts 

LI R12,»0F00 initialize CRU counter 
LOOP AI R12,>0100 increment by 20100 

SBZ 0 turn off DSR peripheral 
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СІ В12,22000 check if at end 


JEQ END stop 
JMP LOOP continue 
END $ 


[access to device] 


B *R11 return 


3.0 Notes on PABs and File Management System 


The Peripheral Access Blocks, or PABs are used in the 
BASIC/XBASIC environment to access the peripheral main devices via the 
File Management System (FMS). The Editor/Assembler manual, section 
18, and Peripheral Technical Data Manual, section C, cover PABs and 
the FMS in great detail and contain programming examples. The 
following notes are provided to assist the developer/programmer when 
designing DSR peripherals that interface with the FMS. 


A) Consider the type of peripheral vs. 115 access mode. Memory 
mapped devices will utilize sequential files. Mass storage devices 
may use either sequential or relative files. Some peripherals may 
only read, and are therefore limited to the INPUT mode. The DSR must 
clearly define which 1/0 modes it will operate in, and generate error 
codes for those that it does not implement. 


B) DSRLNK is used to access the DSR in applications programs that 
bypass the FMS. XBASIC requires a routine like that in Section J. А 
DATA 28 directive after the BLWP GDSRLNK is for linkage to a main 
device routine, and >A for a low level routine. 


C) DSR detected errors should be indicated in the flag byte (1) 
of the РАВ. Тһе DSR should save the least significant 4 bits of the 
1/0 opcode byte or the most significant 5 bits of the flag byte. 


Figure K.1: PAB Flag Byte 


5 6 7 
E E E 
|--|--|----3 BIT ERROR CODE 

It is the responsibility of the DSR to set bits 5-7 in the flag 


byte to inidicate errors that occured within the 058. Table К.1 
defines the error codes. 


D) The DSR is responsible for updating byte 8 (screen offset) of 
the PAB when a STATUS 1/0 opcode 15 issued. When a STATUS (>09) code 
is issued, the applications program can check on the current status of 
the peripheral. The first six bits have meaning regardless if the 
file is currently open or not. The last two bits are valid for open 
files only. Some 0585 such as the decoded CLOCK DSR in Section I до 
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not implement the STATUS 1/0 response; it is recommended that all 0585 
be capable of responding to this opcode. 


TABLE K.1: ERROR CODES FOR DSRS 


Error code Meaning 


000 
001 
010 
011 
100 
101 
110 
111 


Status bit 


Q — го Co оло м 


no error or bad device name if bit 2 of 2837С is set by FMS 
device is write protected 

bad open attribute or no records in relative file 

illegal operation 

out of buffer space on the device 

attempt to read past EOF, or non existent relative record 
device error 

file error 


TABLE K.2: STATUS BIT DEFINITION 


Meaning 
logical end of file; 1-EOF, cannot read more 


physical end of file; 1=end of physical media 
record type; t=variable 0-Ғіхеа 

file type; 1=program O-data 

data type; 1=BINARY/INTERNAL O-ASCII/DISPLAY 
reserved set to zero 

protect flag; 1=protected Q=not protected 
non-existent file 


